home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / telecomm / fido / mm_1_0.lha / MM / Docs / MM_Docs_ENG < prev    next >
Encoding:
Text File  |  1995-03-10  |  148.3 KB  |  4,486 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                             M A I L   M A N A G E R
  11.  
  12.                                     v. 1.0
  13.  
  14.  
  15.  
  16.                                 Full Integrated
  17.                       Tosser/Scanner/Editor/Tick Processor
  18.  
  19.  
  20.                                  Copyright (C)
  21.                             1994/1995 Pino Aliberti 
  22.                              All  rights  reserved
  23.  
  24.  
  25.  
  26.  
  27.                                   USER MANUAL
  28.  
  29.                               Saturday  11-Mar-95
  30.  
  31.  
  32.                                  Copyright (C)
  33.                             1994/1995 Pino Aliberti 
  34.                              All  rights  reserved
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.   INDEX
  44. ---------
  45.  
  46. 0  INTRODUCTION
  47.   0.1  Overall
  48.   0.2  Bonds
  49.   0.3  Installation
  50.   0.4  Running Mail Manager
  51.   0.5  OnLine Help
  52.   0.6  Features
  53.  
  54. 1  MAIL MANAGER CONFIGURATION & MM_PREFS
  55.  
  56.   1.1  System
  57.     1.1.1  Sysop Names
  58.     1.1.2  Addresses
  59.     1.1.3  Groups
  60.  
  61.   1.2  Misc 1
  62.     1.2.1  Fonts
  63.     1.2.2  Tick Commands
  64.     1.2.3  Archivers
  65.  
  66.   1.3  Misc 2
  67.     1.3.1  Variables
  68.       1.3.1.1  Check Dupes
  69.         1.3.1.1.1  Messages
  70.         1.3.1.1.2  Ticks
  71.       1.3.1.2  Areas List
  72.         1.3.1.2.1  Show
  73.         1.3.1.2.2  Order
  74.       1.3.1.3  PreParse Strings
  75.         1.3.1.3.1  Kludges
  76.         1.3.1.3.2  Quoted
  77.       1.3.1.4  Delete Char
  78.       1.3.1.5  Switches
  79.         1.3.1.5.1  5D Origins
  80.         1.3.1.5.2  Check Domains
  81.         1.3.1.5.3  Crunch Matrix
  82.         1.3.1.5.4  Do Backup
  83.         1.3.1.5.5  Keep Matrix
  84.         1.3.1.5.6  Keep Sysop
  85.         1.3.1.5.7  Pack Every Bundle
  86.         1.3.1.5.8  Quote Kludges
  87.         1.3.1.5.9  Reflow Messages
  88.         1.3.1.5.10 Safe Import
  89.         1.3.1.5.11 Show Kludges
  90.         1.3.1.5.12 Show PassThrough
  91.         1.3.1.5.13 Smart Export
  92.         1.3.1.5.14 Threads Opened
  93.         1.3.1.5.15 Text Styles
  94.     1.3.2  Paths
  95.       1.3.2.1  Editor
  96.       1.3.2.2  Archive File
  97.       1.3.2.3  Inbound Dir
  98.       1.3.2.4  Outbound Dir
  99.       1.3.2.5  Bad Dir
  100.       1.3.2.6  Bundle Dir
  101.       1.3.2.7  Backup Dir
  102.       1.3.2.8  Tic Dir
  103.       1.3.2.9  Working Dir
  104.       1.3.2.10 Temp Pkt Dir
  105.       1.3.2.11 Nodelist Dir
  106.       1.3.2.12 Mail Device
  107.       1.3.2.13 Userlist
  108.       1.3.2.14 Statistics
  109.     1.3.3  Sizes
  110.       1.3.3.1  Task Priority
  111.       1.3.3.2  Min Free Mem
  112.       1.3.3.3  Max Pkt Size 
  113.       1.3.3.4  Max Bundle Size
  114.       1.3.3.5  Commands Stack
  115.     1.3.4  Logs
  116.       1.3.4.1  Window
  117.       1.3.3.2  File
  118.  
  119.   1.4  Texts
  120.     1.4.1  Prologues
  121.     1.4.2  Logos
  122.     1.4.3  Origins
  123.     1.4.4  Forward
  124.  
  125.   1.5  Custom
  126.     1.5.1  Areas/Messages Commands
  127.     1.5.2  Browse Commands
  128.  
  129.   1.6  Nodes
  130.     1.6.1  Packets
  131.      1.6.1.1  Archivers
  132.      1.6.1.2  Packets
  133.      1.6.1.3  Flavors
  134.      1.6.1.4  Passwords
  135.     1.6.2  Groups
  136.     1.6.3  Areas
  137.     1.6.4  Misc
  138.      1.6.4.1  UserFlags
  139.      1.6.4.2  Can Create Areas
  140.  
  141.   1.7  Routing
  142.     1.7.1  Settings
  143.       1.7.1.1  Original Message
  144.       1.7.1.2  Action
  145.       1.7.1.3  To
  146.     1.7.2  Test
  147.  
  148.   1.8  Areas
  149.     1.8.1  Messages
  150.       1.8.1.1  System
  151.        1.8.1.1.1  Name
  152.        1.8.1.1.2  Desc
  153.        1.8.1.1.3  Path
  154.        1.8.1.1.4  AltPath
  155.        1.8.1.1.5  UserFlags
  156.        1.8.1.1.6  Address
  157.        1.8.1.1.7  Group
  158.       1.8.1.2  Nodes
  159.       1.8.1.3  Texts
  160.       1.8.1.4  Misc
  161.        1.8.1.4.1  Read Only
  162.        1.8.1.4.2  Two pass Import
  163.        1.8.1.4.3  CharSet
  164.        1.8.1.4.4  Delete By
  165.        1.8.1.4.5  Font
  166.        1.8.1.4.6  Msgbase
  167.        1.8.1.4.7  Show
  168.        1.8.1.4.8  Sort
  169.     1.8.2  Ticks
  170.       1.8.2.1  System
  171.        1.8.2.1.1  Desc
  172.        1.8.2.1.2  Path
  173.        1.8.2.1.3  AltPath
  174.        1.8.2.1.4  UserFlags
  175.        1.8.2.1.5  Address
  176.        1.8.2.1.6  Group
  177.       1.8.2.2  Nodes 
  178.       1.8.2.3  Tick Commands
  179.  
  180.  
  181. 2  MAIL MANAGER GRAPHICAL USER INTERFACE
  182.  
  183.   2.1  Areas Window
  184.     2.1.1  Areas List
  185.     2.1.2  Areas Management
  186.       2.1.2.1  All
  187.       2.1.2.2  None
  188.       2.1.2.3  Import
  189.       2.1.2.4  Export
  190.       2.1.2.5  Scan
  191.       2.1.2.6  Free
  192.       2.1.2.7  Update
  193.       2.1.2.8  Optimize
  194.       2.1.2.9  Delete
  195.       2.1.2.10 Purge
  196.       2.1.2.11 Show
  197.       2.1.2.12 Sort
  198.     2.1.3  Areas Window Menus
  199.       2.1.3.1 Project
  200.         2.1.3.1.1  About
  201.         2.1.3.1.2  Quit
  202.       2.1.3.2  Configuration
  203.         2.1.3.2.1  Edit
  204.         2.1.3.2.2  Load...
  205.         2.1.3.2.3  Save
  206.         2.1.3.2.4  Save As...
  207.       2.1.3.3  Ticks
  208.         2.1.3.3.1  Import
  209.         2.1.3.3.2  Hatch
  210.       2.1.3.4  Miscellaneous
  211.         2.1.3.4.1  File Request
  212.         2.1.3.4.2  Area Statistics
  213.         2.1.3.4.3  Renumber
  214.         2.1.3.4.4  Convert Message Base
  215.         2.1.3.4.5  Deep Scan
  216.         2.1.3.4.6  Write Stats
  217.         2.1.3.4.7  Restore Bad
  218.       2.1.3.5  Domains
  219.       2.1.3.6  User
  220.  
  221.   2.2  Messages Window
  222.     2.2.1  Messages List
  223.     2.2.2  Messages Management
  224.       2.2.2.1  All
  225.       2.2.2.2  None
  226.       2.2.2.3  Search
  227.       2.2.2.4  Flags
  228.       2.2.2.5  R News
  229.       2.2.2.6  R Slct
  230.       2.2.2.7  Write
  231.       2.2.2.8  Forward
  232.       2.2.2.9  Edit
  233.       2.2.2.10  Edit Hdr
  234.       2.2.2.11  Reply
  235.       2.2.2.12  X Reply
  236.       2.2.2.13  Show
  237.       2.2.2.14  Sort
  238.     2.2.3  Messages Window Menus
  239.       2.2.3.1  Messages
  240.         2.2.3.1.1  Delete
  241.         2.2.3.1.2  Protect
  242.         2.2.3.1.3  Mark
  243.         2.2.3.1.4  Archive
  244.         2.2.3.1.5  Print
  245.         2.2.3.1.6  Toggle UnReplied Flag
  246.       2.2.3.2  Miscellaneous
  247.         2.2.3.2.1  File Request
  248.         2.2.3.2.2  Areas Window
  249.         2.2.3.2.3  Areas List
  250.         2.2.3.2.4  Previous Area
  251.         2.2.3.2.5  Next Area
  252.         2.2.3.2.6  Previous UnRead Area
  253.         2.2.3.2.7  Next UnRead Area    
  254.         2.2.3.2.8  Export Area
  255.       2.2.3.3  User
  256.  
  257.   2.3  Browse Window
  258.     2.3.1  Browse Window Gadgets
  259.       2.3.1.1  Threads
  260.       2.3.1.2  Write
  261.       2.3.1.3  Forward
  262.       2.3.1.4  Edit
  263.       2.3.1.5  Edit Hdr
  264.       2.3.1.6  Reply
  265.       2.3.1.7  X Reply
  266.     2.3.2  Browse Window Menus
  267.       2.3.2.1  Messages
  268.         2.3.2.1.1  Delete
  269.         2.3.2.1.2  Protect
  270.         2.3.2.1.3  Mark
  271.         2.3.2.1.4  Archive
  272.         2.3.2.1.5  Print
  273.         2.3.2.1.6  Toggle UnReplied Flag
  274.       2.3.2.2  Miscellaneous
  275.         2.3.2.2.1  File Request
  276.         2.3.2.2.2  Areas Window
  277.         2.3.2.2.3  Areas List
  278.         2.3.2.2.4  Previous Area
  279.         2.3.2.2.5  Next Area
  280.         2.3.2.2.6  Previous UnRead Area
  281.         2.3.2.2.7  Next UnRead Area    
  282.         2.3.2.2.8  Export Area
  283.       2.3.2.3  Environment
  284.         2.3.2.3.1  Text Styles
  285.         2.3.2.3.2  Show Kludges
  286.         2.3.2.3.3  Quote Kludges
  287.       2.3.2.4  User
  288.     2.3.3  Browse Window ShortCuts
  289.       2.3.3.1  Left
  290.       2.3.3.2  Right
  291.       2.3.3.3  Shift+Left
  292.       2.3.3.4  Shift+Right
  293.       2.3.3.5  Alt+Left
  294.       2.3.3.6  Alt+Right
  295.       2.3.3.7  Control+Left
  296.       2.3.3.8  Control+Right
  297.       2.3.3.9  Space
  298.       2.3.3.10 Shift+Space
  299.       2.3.3.11 Return
  300.       2.3.3.12 Del
  301.  
  302.   2.4  Message Parameters Window
  303.     2.4.1  From
  304.     2.4.2  To
  305.     2.4.3  Subj
  306.     2.4.4  Origin
  307.     2.4.5  Flavor
  308.     2.4.6  Private
  309.     2.4.7  Reflow Text
  310.     2.4.8  File Attached
  311.     2.4.9  Force Address
  312.     2.4.10 Multi Send
  313.     2.4.11 Receipt Request
  314.  
  315.  
  316. 3  MAIL MANAGER AREXX INTERFACE
  317.  
  318.   3.1  Standard MUI ARexx Commands
  319.     3.1.1  Quit
  320.     3.1.2  Hide
  321.     3.1.3  Show
  322.     3.1.4  Help
  323.  
  324.   3.2  Mail Manager Internal ARexx Commands
  325.     3.2.1  Ticks Management
  326.       3.2.1.1  MM_ImportTicks
  327.       3.2.1.2  MM_HatchTick
  328.     3.2.2  Areas Management
  329.       3.2.2.1  MM_Import
  330.       3.2.2.2  MM_Export
  331.       3.2.2.3  MM_Rescan
  332.       3.2.2.4  MM_Scan
  333.       3.2.2.5  MM_Free
  334.       3.2.2.6  MM_Update
  335.       3.2.2.7  MM_WriteStats
  336.       3.2.2.8  MM_Renumber
  337.       3.2.2.9  MM_Optimize
  338.       3.2.2.10  MM_Delete
  339.       3.2.2.11  MM_Purge
  340.       3.2.2.12  MM_CleanArea
  341.     3.2.3  Messages Management
  342.       3.2.3.1  MM_EditMsgFlags
  343.       3.2.3.2  MM_SearchMsgs
  344.       3.2.3.3  MM_ReadMsg
  345.       3.2.3.4  MM_WriteMsg
  346.       3.2.3.5  MM_EditMsg
  347.       3.2.3.6  MM_DeleteMsg
  348.     3.2.4  Configuration Management
  349.       3.2.4.1  MM_LoadCfg
  350.       3.2.4.2  MM_SaveCfg
  351.       3.2.4.3  MM_GetSysop
  352.       3.2.4.4  MM_GetAddrs
  353.       3.2.4.5  MM_GetNearestAddr
  354.       3.2.4.6  MM_GetGroups
  355.       3.2.4.7  MM_GetGroupAreas
  356.       3.2.4.8  MM_GetGroupTickAreas
  357.       3.2.4.9  MM_GetNodes
  358.       3.2.4.10  MM_GetNodeInfo
  359.       3.2.4.11  MM_GetCfgPaths
  360.       3.2.4.12  MM_GetAreas
  361.       3.2.4.13  MM_GetAreaInfo
  362.       3.2.4.14  MM_CreateArea
  363.       3.2.4.15  MM_AddAreaNode
  364.       3.2.4.16  MM_DelAreaNode
  365.       3.2.4.17  MM_GetTickAreas
  366.       3.2.4.18  MM_GetTickAreaInfo
  367.       3.2.4.19  MM_AddTickAreaNode
  368.       3.2.4.20  MM_DelTickAreaNode
  369.     3.2.5  Miscellaneous Management
  370.       3.2.5.1  MM_GetNodelistNode
  371.       3.2.5.2  MM_RequestFiles
  372.       3.2.5.3  MM_AddToFlow
  373.       3.2.5.4  MM_AreasWin
  374.       3.2.5.5  MM_WriteLog
  375.       3.2.5.6  MM_CloseLog
  376.     3.2.6  Requesters Management
  377.       3.2.6.1  MM_Requester
  378.       3.2.6.2  MM_StringReq
  379.       3.2.6.3  MM_FileReq
  380.       3.2.6.4  MM_AreaReq
  381.       3.2.6.5  MM_SingleSelReq
  382.       3.2.6.6  MM_MultiSelReq
  383.     3.2.7  Stems Management
  384.       3.2.7.1  MM_WriteStem
  385.       3.2.7.2  MM_ReadStem
  386.       3.2.7.3  MM_SearchInStem
  387.       3.2.7.4  MM_AddToStem
  388.       3.2.7.5  MM_SortStem
  389.       3.2.7.6  MM_SortAddresses
  390.     3.2.8  Files Management
  391.       3.2.8.1  MM_CRCFile
  392.       3.2.8.2  MM_CopyFile
  393.       3.2.8.3  MM_MoveFile
  394.       3.2.8.4  MM_DeleteFile
  395.       3.2.8.5  MM_SetFileNote
  396.  
  397. 4  MISCELLANEOUS
  398.   4.1  Support
  399.   4.2  Registration
  400.   4.3  About MUI
  401.   4.4  MUI Hints & Tips
  402.   4.5  Licence Agreement
  403.   4.6  Acknowledgements
  404.  
  405.  
  406.  
  407.  
  408. 0  INTRODUCTION
  409.  
  410.   This  document describes, in short, but hopefully thorough, terms how to
  411.   use the different functions in Mail Manager.
  412.   Please  read it carefully !  Many of the problems a user can have in the
  413.   use of a program, can be solved by carefully reading the manual.
  414.  
  415.  
  416.   0.1  Overall
  417.  
  418.     Mail  Manager  is  a  Full Integrated Tosser, Scanner, Editor and Tick
  419.     Processor for Nodes and Points using Amiga Computers.
  420.  
  421.     The  Mail Manager project was born two years ago with one big aim:  to
  422.     create  the  Mail Management Program the Amiga users have always dream
  423.     about:   easy  to use as Spot, complete as EMS, smart and intuitive as
  424.     Point  Manager.  I don't know if Mail Manager has already reached this
  425.     aim,  but  I've  worked really much on it and I hope you will like the
  426.     result.
  427.  
  428.     Mail  Manager uses the MagicUserInterface (MUI) by Stefan Stuntz, this
  429.     gives to Mail Manager a unique Graphical User Interface.
  430.     With  MUI you can configure almost everything of the Mail Manager GUI,
  431.     besides  you  can  control  everything with the mouse or even with the
  432.     keyboard.   In  order to completelly exploit such a powerful interface
  433.     you should read MUI's documentation carefully.
  434.    
  435.  
  436.   0.2  Bonds
  437.  
  438.     Mail Manager requires only a few bonds to work properly:
  439.  
  440.     - Kickstart 2.04 or higher
  441.     - MUI 2.0 or higher
  442.  
  443.  
  444.   0.3  Installation
  445.  
  446.     Please use the appropriate installation icon in the `Install' drawer.
  447.     It  uses  Commodore's Installer utility and will copy all the files in
  448.     the appropriate directories, it will also add some assignments to your
  449.     User-Startup  and  will  ask you  some information to create a default
  450.     configuration.   After  that you will be immediatelly able to run Mail
  451.     Manager.
  452.  
  453.  
  454.   0.4  Running Mail Manager
  455.  
  456.     You  can  run  Mail Manager from the Workbench or from the Shell.  The
  457.     command line syntax for Mail Manager is:
  458.  
  459.         MM  [CFG=<CFG File>]  [I]
  460.  
  461.     If  you  do not specify a configuration file, Mail Manager looks for a
  462.     file called "MM:Config/MailManager.CFG".
  463.     If  you  specify  the  'I' option Mail Manager will start in iconified
  464.     state.   Be  careful, when Mail Manager is launched in iconified state
  465.     it is not able to report you the possible configuration errors.
  466.  
  467.  
  468.   0.5  OnLine Help
  469.  
  470.     Mail Manager offers you a powerful OnLine Help function.  Wherever you
  471.     are inside Mail Manager and MM_Prefs, you could press the Help Key and
  472.     Mail Manager will show you the right part of the Mail Manager manual.
  473.  
  474.  
  475.   0.6  Features
  476.  
  477.     Mail Manager...
  478.  
  479.      ... is Faaaaaaaast.  Up to 3 times faster than Spot or EMS.
  480.      ... is easy to configure.
  481.      ... is fully localized ( Workbench 2.1 or higher).
  482.      ... is able to manage Tick Files.
  483.      ... is able to manage Echo File Attached.
  484.      ... is able to automatically create new Echo Areas.
  485.      ... is able to manage 4 different types of message bases.
  486.      ... is able to manage 3 different types of Mail Packets.
  487.      ... is able to use full 5 dimensional addressing.
  488.      ... has a powerful ARexx interface.
  489.      ... has a powerful OnLine Help.
  490.      ... has a powerful Threads management.
  491.      ... has a powerful NetMail Routing management.
  492.      ... has powerful Search/Sort/Show functions.
  493.      ... has powerful Quoting routines.
  494.      ... supports multiple character sets.
  495.      ... supports the Nodelist and the Userlist.
  496.      ... uses fast Memory Pools functions.
  497.      ... uses fast asynchronous I/O functions.
  498.      ... is a  MUI  Application !!!!
  499.      ... has many many other features !
  500.  
  501.  
  502.  
  503.  
  504.  
  505. 1  MAIL MANAGER CONFIGURATION & MM_PREFS
  506.  
  507.   Mail Manager is a really complex program, nevertheless I've made my best
  508.   to make its configuration as easy as possible.
  509.   The  format of its configuration file is plain text so it is possible to
  510.   edit  it  with a normal TextEditor, however it is better to use MM_Prefs
  511.   to  edit  the  Mail  Manager  configuration,  as it prevents any kind of
  512.   syntax error and makes everything easier.
  513.   You  can start MM_Prefs from inside Mail Manager with the 'Edit' item of
  514.   the  Configuration Menu, or, if Mail Manager is not running, from either
  515.   the Shell or the Workbench.
  516.   MM_Prefs  depends heavily on the use of MUI's Register Objects; in order
  517.   to  completelly  exploit the properties of these objects you have to set
  518.   "Register  Level"  to  at  least  3 and "Max Pages" to at least 8 in the
  519.   "Lists"  page  of  MUIPrefs, otherwise MUI's Register Object will switch
  520.   back to a standard cycle gadget.
  521.  
  522.  
  523.  
  524.   1.1  System
  525.  
  526.     1.1.1  Sysop Names
  527.  
  528.       Here you can insert the names you want to use in the Messages Areas.
  529.       The entry labeled as <Default> is the Default Sysop Name, it will be
  530.       used  in  all  the  areas  where you have not specified a particular
  531.       Sysop Name.
  532.       In  the  "Label"  string  gadget  you have to insert a symbolic name
  533.       associated  to  the  Sysop Name,  all  the  rest  of the system will
  534.       refer to the Sysop Name with this label.
  535.       In  the  "Name"  string  gadget  you  have  to insert the Sysop Name
  536.       itself.
  537.  
  538.  
  539.     1.1.2  Addresses
  540.  
  541.       Here you  can   insert  all  your  Addresses.  You have to enter the
  542.       Address  in 5D format ( <zone>:<net>/<node>.<point>@<domain> ).  The
  543.       domain  string  should  not  include the extension ( for example use
  544.       "fidonet"  and  not  "fidonet.org" ) and should not be longer than 8
  545.       chrs; this is a limit introduced by Fidonet standards, not from Mail
  546.       Manager itself.
  547.       The  Fakenet is a Fake Address used, for managing points, with stone
  548.       aged  systems  that  only could manage 2D addresses.  If you want to
  549.       disable  the  use of the FakeNet also with 2D systems you should set
  550.       it to 0.
  551.       In  a  standard  configuration  you have to use a single Address for
  552.       every Domain, if you have more than one Address for every Domain you
  553.       should  flag  them  as  Akas;  this way Mail Manager won't scan them
  554.       during the search for your address nearer to a particular node.
  555.       As  a general rule, you have to flag as Aka all the Addresses you do
  556.       not want to normally use as originating address of your messages.
  557.  
  558.  
  559.     1.1.3  Groups
  560.  
  561.       Here you  can  insert all the Groups.  Groups are really useful only
  562.       for  Full  Nodes  that  use  them mainly for AreaFix.  Anyway also a
  563.       simple  Point  could  use them for grouping together some areas with
  564.       the  same  characteristics.   If  you  do not need Groups, you could
  565.       define a single group and link all the areas to this group.
  566.  
  567.  
  568.  
  569.  
  570.   1.2  Misc 1
  571.  
  572.     1.2.1  Fonts
  573.  
  574.       By  default  Mail  Manager  uses the fonts configured with MUIPrefs.
  575.       Anyway it is possible that you want to use a particular font to show
  576.       the  text of a message ( for example an IBM font for an area with an
  577.       IBM  charset  ).   Here you can insert all the fonts you plan to use
  578.       inside the messages areas.
  579.       In  the  "Label"  string  gadget  you have to insert a symbolic name
  580.       associated  to  the  Font, all the rest of the system will refer the
  581.       Font with this label.
  582.       In  the  "Font"  string gadget you have to insert the Font itself in
  583.       the format <fontname>/<fontsize>.
  584.  
  585.  
  586.     1.2.2  Tick Commands
  587.  
  588.       Mail  Manager  offers  you  the  possibility  of  launching a custom
  589.       command everytime it processes a Tick File.
  590.       When  Mail  Manager  processes a Tick File it performs the following
  591.       operations:
  592.        - If there is a file to replace, MM deletes the file from the area
  593.        - it copies the file into the directory specified as Area Path.
  594.        - it inserts the description of the file inside the file comment.
  595.       If  you  want to perform some other operations you could insert them
  596.       inside  a script and configure it as a Tick Command.  The configured
  597.       script   will   be  launched  immediatelly  after  the  above  three
  598.       operations.
  599.       Inside  the  Command  string  you  can  insert the following control
  600.       characters:
  601.         \n - NewLine
  602.         \q - Quotations Marks (")
  603.         %s - Sysop Name
  604.         %a - Area Tag
  605.         %p - Area Path
  606.         %P - Area Alternate Path
  607.         %u - Area User Flags
  608.         %d - File Description
  609.         %b - File Size in Bytes
  610.         %n - Original File Name ( Only Name )
  611.         %N - Original File Name ( with the complete Path )
  612.         %m - Destination File Name ( Only Name )
  613.         %M - Destination File Name ( with the complete Path )
  614.         %r - File replaced ( Only Name )
  615.         %R - File replaced ( with the complete Path )
  616.         %o - Origin Node
  617.         %f - From Node                                        
  618.  
  619.       WARNINGS
  620.       --------
  621.        -  You  cannot  use  Mail  Manager ARexx commands inside the script
  622.           launched as Tick Command
  623.        -  Mail  Manager checks the return code of the Tick Command.  If it
  624.           is not '0' the Tick file won't be processed any further.
  625.  
  626.       In  the  "Label"  string  gadget  you have to insert a symbolic name
  627.       associated  to  the  Tick  Command,  all the rest of the system will
  628.       refer to the Tick Command with this label.
  629.       In  the  "Com"  string  gadget  you  have to insert the Tick Command
  630.       itself.
  631.  
  632.  
  633.     1.2.3  Archivers
  634.  
  635.       Here  you  can  insert  all  the  archivers  you  plan  to  use  for
  636.       arcing/unarcing mail bundles on your system.
  637.       In  the  "Label"  string  gadget  you have to insert a symbolic name
  638.       associated  to  the  Archiver,  all  the  rest  of  the  system will
  639.       refer to the Archiver with this label.
  640.       In  the  "Arc"  string  gadget  you have to insert the command to be
  641.       executed  for  arcing  mail.  Mail Manager will automatically append
  642.       the  name  of  the bundle and the name of the packet to compress, in
  643.       this order.
  644.       In  the  "UnArc"  string gadget you have to insert the command to be
  645.       executed  for unarcing mail.  Mail Manager will automatically append
  646.       the name of the bundle to UnPack.  The bundle will be unarced in the
  647.       configured WorkDir.
  648.       During  import Mail Manager is able to identify the kind of archiver
  649.       used  to  create  the  bundle.   The  identification  is  based on a
  650.       particular sequence of characters in the first bytes of the bundle:
  651.       "ID"  is the matching sequence of bytes and "ID Pos" is its position
  652.       inside  of the bundle.  These are the ID and ID Pos of the most used
  653.       archivers:
  654.  
  655.       ARCHIVER      ID      ID Pos
  656.       --------    ------    ------
  657.         LHA       "-lh"        2
  658.         LZX       "LZX"        0
  659.         ZOO       "ZOO"        0
  660.         ZIP        "PK"        0
  661.         ARC         ""        0
  662.  
  663.  
  664.  
  665.  
  666.   1.3  Misc 2
  667.  
  668.     1.3.1  Variables
  669.  
  670.       1.3.1.1  Check Dupes
  671.  
  672.         With  these  two Cycle Gadgets you can configure the management of
  673.         Dupe Messages and Tick Files.
  674.  
  675.         1.3.1.1.1  Messages
  676.  
  677.           With  this Cycle Gadget you can configure the management of Dupe
  678.           Messages.
  679.  
  680.           Disabled     - No Dupe Checking
  681.           Keep         - The  Dupe  Message is recognized as a Dupe but it
  682.                          is normally imported 
  683.           Route to Bad - The  Dupe  Message is recognized  as a  Dupe  and
  684.                          imported in the configured BAD Messages area.
  685.                          The message will be flagged as 'Dupe'.
  686.           Kill         - The  Dupe  Message is recognized as a Dupe and it
  687.                          is not imported at all.
  688.  
  689.  
  690.         1.3.1.1.1  Ticks
  691.  
  692.           With  this Cycle Gadget you can configure the management of Dupe
  693.           Tick Files.
  694.  
  695.           Disabled     - No Dupe Checking
  696.           Keep         - The  Dupe  File is recognized as a Dupe.  The old
  697.                          file  is moved to the configured BackUp directory
  698.                          and the new file is normally imported.
  699.           Route to Bad - The  Dupe  File  is  recognized  as  a  Dupe  and
  700.                          imported in the configured Bad Dir.
  701.           Kill         - The  Dupe  File is recognized as a Dupe and it is
  702.                          not imported at all.
  703.  
  704.  
  705.  
  706.       1.3.1.2  Areas List
  707.  
  708.         With  these two Cycle Gadgets you can configure the default status
  709.         of  the  corresponding  Cycle  Gadgets of the Areas Window of Mail
  710.         Manager:
  711.  
  712.         1.3.1.2.1  Show
  713.  
  714.           This Cycle gadget configures the default type of areas that will
  715.           be showed in the Areas List of the Areas Window of Mail Manager.
  716.  
  717.           All  - Shows all the areas.
  718.           Tot  - Shows only areas which contain messages.
  719.           New  - Shows only areas which contain UnRead messages.
  720.           Sys  - Shows only areas which contain UnRead messages  addressed
  721.                  to you.
  722.           Unr  - Shows   only   areas  which  contain  UnReplied  messages
  723.                  addressed to you.
  724.           Imp  - Shows only areas which contain messages  imported  during
  725.                  the last import.
  726.           Echo - Shows only EchoMail areas
  727.           Mail - Shows only NetMail areas
  728.  
  729.  
  730.         1.3.1.2.2  Order
  731.  
  732.           This  Cycle gadget configures the default sorting method used in
  733.           the Areas List of the Areas Window of Mail Manager:
  734.  
  735.           Configuration - Sorts  areas  in the  same  order  as  they  are
  736.                           described in the configuration file.
  737.           Alphabetic    - Sorts areas in alphabetical order of their name
  738.           Groups        - Sorts areas in alphabetical order of their group
  739.           Number Tot    - Sorts  areas  by  the  total  number of messages
  740.                           contained in the area
  741.           Number New    - Sorts  areas  by  the  number of UnRead messages
  742.                           contained in the area
  743.           Number Sys    - Sorts  areas  by  the  number of UnRead messages
  744.                           addressed to you contained in the area
  745.           Number Unr    - Sorts  areas by the number of UnReplied messages
  746.                           addressed to you contained in the area
  747.           Number Imp    - Sorts  areas  by the number of messages imported
  748.                           during the last import
  749.  
  750.  
  751.  
  752.       1.3.1.3  PreParse Strings
  753.  
  754.          In  these two string gadgets you can insert a string that will be
  755.          placed  in  front  of  every Kludge and Quoted line while you are
  756.          reading  a  message.  In the string you can include the following
  757.          control characters:
  758.  
  759.             \b   = Bold
  760.             \i   = Italic
  761.             \u   = Underline
  762.             \n   = Back to Plain
  763.             \<n> = Use  pen  number  <n>  (1..9).  You  can  configure the
  764.                    colors  associated  to  these  pens  from the 'Palette'
  765.                    window of the Edit Screens part of MUIPrefs.
  766.  
  767.         1.3.1.3.1  Kludges
  768.  
  769.           Here you  can  insert the string that will be placed in front of
  770.           every Kludge line.
  771.  
  772.         1.3.1.3.2  Quoted
  773.  
  774.           Here you  can  insert the string that will be placed in front of
  775.           every Quoted line.
  776.  
  777.  
  778.  
  779.       1.3.1.4  Delete Char
  780.  
  781.         In  this  string  gadget you can insert the control character that
  782.         will  be  inserted in front of the Bundle name before adding it to
  783.         a  Flow  File.   This  will configure the management of the Bundle
  784.         after it has been sent by your mailer:
  785.  
  786.           # ... Truncate the bundle to zero length 
  787.           ^ ... Delete the bundle (with logging) 
  788.           - ... Delete the bundle (without logging) 
  789.  
  790.  
  791.  
  792.       1.3.1.5  Switches
  793.  
  794.         1.3.1.5.1  5D Origins
  795.  
  796.           If  you set this CheckMark, the address inserted by Mail Manager
  797.           at the end of the Origin line will include the domain.
  798.  
  799.  
  800.         1.3.1.5.2  Check Domains
  801.  
  802.           If  you  set this CheckMark, Mail Manager will work in a full 5D
  803.           environment.   In  a full 5D environment, 2:335/602.2@fidonet is
  804.           completely different from 2:335/602.2@amiganet.
  805.           This  gadget  should always be selected; unselect it only if you
  806.           are connected to someone that is unable to use the right domains.
  807.  
  808.  
  809.         1.3.1.5.3  Crunch Matrix
  810.  
  811.           If  you  set  this  CheckMark,  NetMail  for your Points will be
  812.           crunched  with  the  configured archiver.  The format of netmail
  813.           packets  for  all  the  other nodes is configured by the routing
  814.           parameter.
  815.           Of course this is only useful if you are a full node.
  816.  
  817.  
  818.         1.3.1.5.4  Do Backup
  819.  
  820.           If  you set this CheckMark, Mail Manager will make a copy of the
  821.           incoming  bundles and PKTs in the Backup Dir before starting the
  822.           Import function.
  823.  
  824.  
  825.         1.3.1.5.5  Keep Matrix
  826.  
  827.           By default, intransit messages ( Imported messages not addressed
  828.           to one of your Addresses or Akas ), are flagged as 'DEL' as soon
  829.           as  Mail  Manager  has  exported them.  If you also want to keep
  830.           intransit messages you have to set this CheckMark.
  831.           Of course this is only useful if you are a full node.
  832.  
  833.  
  834.         1.3.1.5.6  Keep Sysop
  835.  
  836.           If  you set this CheckMark, messages written or addressed to you
  837.           won't be deleted by the Mail Manager Delete Function.  Of course
  838.           you  can still delete them by setting the 'DEL' flag from inside
  839.           Mail Manager.
  840.  
  841.  
  842.         1.3.1.5.7  Pack Every Bundle
  843.  
  844.           If  you  set  this CheckMark, Mail Manager will archive exported
  845.           Packets  at  the end of every imported bundle, otherwise it will
  846.           archive the exported Packets at the end of the Import function.
  847.  
  848.  
  849.         1.3.1.5.8  Quote Kludges
  850.  
  851.           This  CheckMark  sets  the  default  status of the Quote Kludges
  852.           item of the Environment menu in the Browse window.
  853.  
  854.  
  855.         1.3.1.5.9  Reflow Messages
  856.  
  857.           This  CheckMark  sets the default status of the Reflow Gadget in
  858.           the Message Parameters Window.
  859.  
  860.  
  861.         1.3.1.5.10  Safe Import
  862.  
  863.           If  you set this CheckMark, Mail Manager will delete an incoming
  864.           Bundle only after it has imported all the contained packets.
  865.           You are advised to  enable this option if you  have assigned the
  866.           Working Dir to somewhere in RAM:.  This prevents you from losing
  867.           messages in case of a crash during import.
  868.  
  869.  
  870.         1.3.1.5.11 Show Kludges
  871.  
  872.           This  CheckMark sets the default status of the Show Kludges item
  873.           of the Environment menu in the Browse window.
  874.  
  875.  
  876.         1.3.1.5.12 Show PassThrough
  877.  
  878.           If  you set this CheckMark, PassThrough Areas will be visible in
  879.           the Areas List of the Areas Window.
  880.  
  881.  
  882.         1.3.1.5.13 Smart Export
  883.  
  884.           If  you  set  this  CheckMark then, when you click on the Export
  885.           Gadget  of  the Areas window and there is no Area Selected, Mail
  886.           Manager will Export only areas flagged with the 'E' flag.
  887.  
  888.  
  889.         1.3.1.5.14 Threads Opened
  890.  
  891.           This CheckMark sets the default status of the Threads Window.
  892.           
  893.  
  894.         1.3.1.5.15 Text Styles
  895.  
  896.           This  CheckMark  sets the default status of the Text Styles item
  897.           of the Environment menu in the Browse window.
  898.  
  899.  
  900.  
  901.     1.3.2  Paths
  902.  
  903.       1.3.2.1  Editor
  904.  
  905.         In  this  string  gadget you should insert the editor command that
  906.         will be executed by Mail Manager to edit a message.  Put a `%s' in
  907.         this  command  string  to specify where Mail Manager should insert
  908.         the name of the temporary file.
  909.         The  Editor  should be runned in a synchronous way ( it should not
  910.         return until you close it ).  For example, with CED you should use
  911.         "CED %s -sticky".
  912.  
  913.  
  914.       1.3.2.2  Archive File
  915.  
  916.         In  this string gadget you can insert the default name of the file
  917.         where Mail Manager will save a Message when you archive it.
  918.         You can use the same control characters used for the Prologue Text.
  919.  
  920.  
  921.       1.3.2.3  Inbound Dir
  922.  
  923.         In  this  string  gadget  you can insert the name of the directory
  924.         where  Mail  Manager  will  look for incoming Bundles, Packets and
  925.         Files.   It should be the same directory configured in your mailer
  926.         as Inbound.
  927.  
  928.  
  929.       1.3.2.4  Outbound Dir
  930.  
  931.         In  this  string  gadget  you can insert the name of the directory
  932.         where Mail Manager will place outgoing Packets and Flow Files.  It
  933.         should be the same directory configured in your mailer as Outbound.
  934.  
  935.  
  936.       1.3.2.5  Bad Dir
  937.  
  938.         In  this  string  gadget  you can insert the name of the directory
  939.         where  Mail  Manager will move wrong or corrupted incoming Packets
  940.         and Tick files.
  941.  
  942.  
  943.       1.3.2.6  Bundle Dir
  944.  
  945.         In  this  string  gadget  you can insert the name of the directory
  946.         where  Mail Manager will place outgoing Bundles.  You can also use
  947.         the same directory used for the Outbound Dir.
  948.  
  949.  
  950.       1.3.2.7  Backup Dir
  951.  
  952.         In  this  string  gadget  you can insert the name of the directory
  953.         where  Mail  Manager will copy incoming Bundles and Packets before
  954.         the Import function ( only if you have specified 'Do BackUp' ).
  955.  
  956.  
  957.       1.3.2.8  Tic Dir
  958.  
  959.         In  this  string  gadget  you can insert the name of the directory
  960.         where  Mail  Manager will place outgoing .TIC files.  You can also
  961.         use the same directory used for the Outbound Dir.
  962.  
  963.  
  964.       1.3.2.9  Working Dir
  965.  
  966.         In  this  string  gadget  you can insert the name of the directory
  967.         where Mail Manager will UnArc incoming Bundles before the Import.
  968.  
  969.  
  970.       1.3.2.10 Temp Pkt Dir
  971.  
  972.         In  this  string  gadget  you can insert the name of the directory
  973.         where Mail Manager will create temporary Packets during the Export
  974.         operation.
  975.         It should be different from the Inbound and Working directories.
  976.  
  977.  
  978.       1.3.2.11 Nodelist Dir
  979.  
  980.         In  this  string  gadget  you can insert the name of the directory
  981.         where Mail Manager will look for the compiled Nodelist.
  982.  
  983.  
  984.       1.3.2.12 Mail Device
  985.  
  986.         In  this  string  gadget  you can insert the name of the directory
  987.         that  Mail Manager will monitor in order to show you the available
  988.         disk  space.  It should be the directory or device where you place
  989.         your Message Base.
  990.  
  991.  
  992.       1.3.2.13 Userlist
  993.  
  994.         In  this  string  gadget  you can insert the name of the Userlist.
  995.         Mail Manager uses the following userlist format:
  996.  
  997.         "<Full Name>"    <5D Address>         <nickname>
  998.  
  999.         for example:
  1000.  
  1001.         "Pino Aliberti"  2:335/602.2@fidonet  pino
  1002.  
  1003.  
  1004.       1.3.2.14 Statistics
  1005.  
  1006.         In  this  string  gadget you can insert the name of the Statistics
  1007.         file.    Mail   Manager  uses  this  file  to  store  some  useful
  1008.         information about the status of the messages areas.
  1009.  
  1010.  
  1011.  
  1012.     1.3.3  Sizes
  1013.  
  1014.       1.3.3.1  Task Priority
  1015.  
  1016.         This is the Task Priority of the Mail Manager task.
  1017.  
  1018.  
  1019.       1.3.3.2  Min Free Mem
  1020.  
  1021.        If your available free memory is less than this value, Mail Manager
  1022.        will free some area buffers before scanning an area.
  1023.  
  1024.  
  1025.       1.3.3.3  Max Pkt Size 
  1026.  
  1027.         This  is the rough maximum size of a Packet created during Export.
  1028.         The size of the Packet is checked before adding a message.  If the
  1029.         size  of the Packet is bigger than this value, the message will be
  1030.         added to a new Packet.
  1031.  
  1032.  
  1033.       1.3.3.4  Max Bundle Size
  1034.  
  1035.         This  is  the  very rough  maximum size of a Bundle created during
  1036.         Export.  The size of the Bundle is checked before adding a packet.
  1037.         If  the  size  of the Bundle is bigger than this value, the packet
  1038.         will be added to a new Bundle.
  1039.  
  1040.  
  1041.       1.3.3.5  Commands Stack
  1042.  
  1043.         This   is   the  StackSize  used  for  running  external  commands
  1044.         ( Archivers, Text Editor, Custom Commands and Tick Commands ).
  1045.  
  1046.  
  1047.  
  1048.     1.3.4  Logs
  1049.  
  1050.       1.3.4.1  Window
  1051.  
  1052.         This  is  the window used by Mail Manager to show you a log of the
  1053.         current  Mail Manager session and functions as standard I/O window
  1054.         to run external commands.
  1055.         The  'Lev'  slider  gadget defines Mail Manager's verbosity during
  1056.         writes to the Log Window.
  1057.  
  1058.  
  1059.       1.3.4.2  File
  1060.  
  1061.         This is the name of the Log File written by Mail Manager.
  1062.         The  'Lev'  slider  gadget defines Mail Manager's verbosity during
  1063.         writes to the Log File.
  1064.  
  1065.  
  1066.  
  1067.  
  1068.   1.4  Texts
  1069.  
  1070.     1.4.1  Prologues
  1071.  
  1072.       Here  you  can  insert the Prologues you want to use in the Messages
  1073.       Areas.   The  Prologue  is a phrase that Mail Manager inserts in the
  1074.       head of your reply to a message.
  1075.       The  entry  labeled as <Default> is the Default Prologue, it will be
  1076.       used  in  all  the  areas  where you have not specified a particular
  1077.       Prologue.
  1078.       In the "Label" string gadget you will have to insert a symbolic name
  1079.       associated to the Prologue, all the rest of the system will refer to
  1080.       the Prologue with this label.
  1081.       In the "Prologue" string gadget you will have to insert the Prologue
  1082.       itself.
  1083.       In the phrase you can insert the following control characters:
  1084.  
  1085.        \n - NewLine
  1086.        \q - Quotations Marks (")
  1087.        \% - Percentage char (%)
  1088.  
  1089.        %F - Name of the Sender (Name and SurName)
  1090.        %f - Name of the Sender (Name)
  1091.        %K - Address of the Sender ( without Domain )
  1092.        %k - Address of the Sender ( without Point and Domain )
  1093.        %T - Name of the Addressee (Name and SurName)
  1094.        %t - Name  of the Addressee(Name)
  1095.        %S - Subject of the message (Complete)
  1096.        %s - Subject of the message (First 20 characters)
  1097.        %D - Date and Time of the message
  1098.        %d - Date of the message
  1099.        %X - Current Date and Time
  1100.        %x - Current Date
  1101.        %Y - Sysop Name (Name and Surname)
  1102.        %a - Tag Name of the area
  1103.        %p - Path of the area
  1104.        %n - Number of the message
  1105.  
  1106.       If  %F,  %f, %T or %t are followed by some text enclosed in two `~'s
  1107.       this  text will be used if the message was directed to or written by
  1108.       yourself.  For example:  "Look what %F~I~ wrote to %T~me~:"
  1109.  
  1110.  
  1111.     1.4.2  Logos
  1112.  
  1113.       Here you can insert the Logos you want to use in the Messages Areas.
  1114.       The  Logo  is a signature that Mail Manager adds to the end of every
  1115.       message you write.
  1116.       The  entry labeled as <Default> is the Default Logo, it will be used
  1117.       in all the areas where you have not specified a particular Logo.
  1118.       In the "Label" string gadget you will have to insert a symbolic name
  1119.       associated to the Logo, all the rest of the system will refer to the
  1120.       Logo with this label.
  1121.       In the "Logo" string gadget you will have to insert the Logo itself.
  1122.       In  the  phrase you can insert the same control characters described
  1123.       for Prologues.
  1124.  
  1125.  
  1126.     1.4.3  Origins
  1127.  
  1128.       Here  you  can  insert  the  Origins you want to use in the Messages
  1129.       Areas.
  1130.       The  entry  labeled  as  <Default> is the Default Origin, it will be
  1131.       used  in  all  the  areas  where you have not specified a particular
  1132.       Origin.
  1133.       In the "Label" string gadget you will have to insert a symbolic name
  1134.       associated  to  the Origin, all the rest of the system will refer to
  1135.       the Origin with this label.
  1136.       In the "Origin" string gadget you have to insert the Origin itself.
  1137.  
  1138.  
  1139.     1.4.4  Forward
  1140.  
  1141.       In  the  "Forward"  string gadget you have to insert the phrase that
  1142.       Mail Manager inserts in the head of a forwarded message.
  1143.       In  the  phrase you can insert the same control characters described
  1144.       for Prologues.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.   1.5  Custom
  1150.  
  1151.     1.5.1  Areas/Messages Commands
  1152.  
  1153.       Here  you  can  configure up to  32  custom commands associated with
  1154.       the User Menu of the Areas and Messages windows.
  1155.       In the "Label" string gadget you will have to insert the name of the
  1156.       command, this string will be showed in the menu.
  1157.       In the "ShortCut" string gadget you can insert a character that will
  1158.       be  used  as ShortCut for calling the command.  Of course you cannot
  1159.       use  a  character  already  used  for  another menu item of the same
  1160.       window.
  1161.       In the "Command" string gadget you will  have  to insert the command
  1162.       itself.   Mail  Manager  will  launch the command using the AmigaDOS
  1163.       'Run'  command,  so  you  can also configure a command like:
  1164.       ">nil: BIN:Trapdoor call 2:335/602".
  1165.  
  1166.  
  1167.     1.5.2  Browse Commands
  1168.  
  1169.       Here  you  can configure up to 32 custom commands associated to with
  1170.       the User Menu of the Browse window.
  1171.       In the "Label" string gadget you will have to insert the name of the
  1172.       command, this string will be showed in the menu.
  1173.       In the "ShortCut" string gadget you can insert a character that will
  1174.       be  used  as ShortCut for calling the command.  Of course you cannot
  1175.       use  a  character  already  used  for  another menu item of the same
  1176.       window.
  1177.       In the "Command" string gadget you will  have  to insert the command
  1178.       itself.   Mail  Manager  will  launch the command using the AmigaDOS
  1179.       'Run'  command.   In  the  string  you  can  insert the same control
  1180.       characters   described   for   Prologues,   so   a   command   like:
  1181.       "BIN:Trapdoor  call %k" will make Trapdoor call the originating node
  1182.       of the message you are currently reading.
  1183.  
  1184.  
  1185.  
  1186.  
  1187.   1.6  Nodes
  1188.  
  1189.       Here you can insert all the systems that normally exchange mail with
  1190.       you. If you are a point this is the place where you should configure
  1191.       all  your  bosses. If you  are a  node this is the place  where  you
  1192.       should  configure  all the points and nodes which exchange mail with
  1193.       your system.
  1194.  
  1195.  
  1196.     1.6.1  Packets
  1197.  
  1198.      1.6.1.1  Archivers
  1199.  
  1200.        Here  you  can  select the archiver that will be used to crunch the
  1201.        mail packets addressed to the selected system.
  1202.        The  system  could  send  you mail packets crunched with any of the
  1203.        configured archivers, Mail Manager is able to identify the archiver
  1204.        used to create the bundle.
  1205.  
  1206.  
  1207.      1.6.1.2  Packets
  1208.  
  1209.        Here  you can configure the format of the Mail Packets addressed to
  1210.        the  selected  system  and  the  format  of  Seen-By and Path lines
  1211.        inserted in the packets.
  1212.        Mail  Manager  uses  the  standards  described in  FTS-0001  for 3D
  1213.        packets, in FSC-0048 for 4D packets and in FSC-0045 for 5D packets.
  1214.  
  1215.  
  1216.      1.6.1.3  Flavors
  1217.  
  1218.        Here you can configure the method used to send EchoMail Packets and
  1219.        Tick Files to the selected system.
  1220.        Packets or Tick Files will never be created for a VIRTUAL system.
  1221.  
  1222.  
  1223.      1.6.1.4  Passwords
  1224.  
  1225.        Here you can configure the passwords used with the selected system.
  1226.  
  1227.          Packet  -  Password used/expected for Packets
  1228.          Tick    -  Password used/expected for Tick Files
  1229.          AreaFix -  Password expected for AreaFix Messages
  1230.  
  1231.  
  1232.  
  1233.     1.6.2  Groups
  1234.  
  1235.       From  here  you  can  link/unlink  the  selected  system to/from the
  1236.       defined groups. This is only really useful for full nodes which will
  1237.       mostly use this function for AreaFix.
  1238.  
  1239.  
  1240.  
  1241.     1.6.3  Areas
  1242.  
  1243.       From  here  you  can  link/unlink  the  selected  system to/from the
  1244.       defined EchoMail and Tick Areas.
  1245.  
  1246.  
  1247.  
  1248.     1.6.4  Misc
  1249.  
  1250.      1.6.4.1  UserFlags
  1251.  
  1252.        In  this  string  gadget  you  can insert every kind of information
  1253.        about  the  selected system.  Mail Manager does not use this field,
  1254.        but it could be read from ARexx so you could use it to store useful
  1255.        information for ARexx scripts.  Another possible use is to remember
  1256.        the name of the sysop of the selected system.
  1257.  
  1258.  
  1259.      1.6.4.2  Can Create Areas
  1260.  
  1261.        If  you  set  this  CheckMark,  the selected system will be able to
  1262.        automatically  create  new  EchoMail areas on your system.  The new
  1263.        areas  will  be  created  following  the  values  configured in the
  1264.        Auto-Created Area Default gadgets.
  1265.  
  1266.  
  1267.  
  1268.  
  1269.   1.7  Routing
  1270.  
  1271.     The  Routing  is  the  heart  of NetMail handling.  By configuring the
  1272.     Routing  you tell Mail Manager how and to which system it has to route
  1273.     NetMails  to. This is normally used  to get the message to reach  it's
  1274.     final destination via the shortest route.
  1275.     When  Mail  Manager  exports a NetMail Message it reads the origin and
  1276.     destination addresses and:
  1277.     -  If  the  destination  address  is one of your Addresses or Akas, MM
  1278.        flags  the  message  as  Sent,  updates  some kludges and stops the
  1279.        message.
  1280.     -  If  the  origin  address is one of your Addresses or Akas and it is
  1281.        flagged  as  Hold  or as Crash, MM inserts it in an outgoing packet
  1282.        for the destination node with the proper flavor.
  1283.     -  If you are a node and the destination address is one of your listed
  1284.        points,  MM inserts the message in an outgoing packet for the point
  1285.        with the flavor specified for the point.
  1286.     -  In all the other cases it follows the Routing statements.  It scans
  1287.        the statements from the first to the last ( so order is important )
  1288.        and  as  soon  as  it  finds  a  statement  that  matches  with the
  1289.        destination  address of the message and with its flavor it performs
  1290.        the configured action.
  1291.  
  1292.  
  1293.     1.7.1  Settings
  1294.  
  1295.       Here you can insert all the Routing statements.  Be careful, all the
  1296.       possible addresses must be covered.
  1297.  
  1298.       1.7.1.1  Original Message
  1299.  
  1300.         In  the  Pattern  string gadget you can insert the Address Pattern
  1301.         that  must  be satisfied by the destination address of the message
  1302.         in  order  to perform the corresponding Action.
  1303.         You   have   to   enter   the   Address   Pattern   in  5D  format
  1304.         (  <zone>:<net>/<node>.<point>@<domain>  ).  In every field of the
  1305.         pattern you can use every AmigaDos wilcard.
  1306.         Here are some examples:
  1307.  
  1308.         *:*/*.*@fidonet      - all the msgs addressed to a fidonet node
  1309.         *:*/*.*@amiganet     - all the msgs addressed to an amiganet node
  1310.         [1-6]:*/*.*@*        - all the msgs addressed to zones 1 thru 6
  1311.         ((39)|(40)):*/*.*@*  - all the msgs addressed to zones 39 and 40
  1312.         *:*/*.*@*            - all the msgs
  1313.  
  1314.         The  Flavor  cycle gadget defines the Flavor that the message must
  1315.         own in order to perform the corresponding Action.
  1316.  
  1317.  
  1318.       1.7.1.2  Action
  1319.  
  1320.         SEND    - Sends the message uncompressed
  1321.         ARCHIVE - Sends the message compressed
  1322.  
  1323.  
  1324.       1.7.1.3  To
  1325.  
  1326.         Here  you  can  select  the  Node  where you want to route all the
  1327.         messages that satisfy the Pattern.  You can also define the Flavor
  1328.         used for routing the message.
  1329.  
  1330.  
  1331.  
  1332.     1.7.2  Test
  1333.  
  1334.       Here you can test your Routing statements.
  1335.  
  1336.  
  1337.  
  1338.  
  1339.   1.8  Areas
  1340.  
  1341.     1.8.1  Messages
  1342.  
  1343.       Here  you  can  insert  all the Messages Areas you want to manage on
  1344.       your system.
  1345.       In  the  Tag  string gadget you can insert the TAG-name of the area.
  1346.       You  cannot  use the same TAG-name for two different Messages Areas.
  1347.       Normally this won't happen with EchoMail areas, but you also have to
  1348.       name  your NetMail Areas with different TAG-names, e.g.  MATRIX.FIDO
  1349.       or NETMAIL.AMY.
  1350.       The  Type  cycle  gadget defines the type of the Area.  Mail Manager
  1351.       supports four different types of Messages Areas:
  1352.  
  1353.       MAIL      - NetMail  (Matrix)  Area.   You can configure a single or
  1354.                   multiple  NetMail  Areas.   Even if you are connected to
  1355.                   multiple  domains/nodes,  Mail Manager is able to manage
  1356.                   all  the  Netmail  messages  with a single NetMail Area.
  1357.                   Anyway,  if  you prefer, you can configure  a  different
  1358.                   NetMail Area for every domain/node you are connected to.
  1359.  
  1360.       ECHO      - Standard EchoMail Area.
  1361.  
  1362.       FILE ECHO - EchoMail  Area  with  File  Attached  Management.   Mail
  1363.                   Manager  is  able to manage attached files  in  EchoMail
  1364.                   areas.   Be careful, File Attaches in EchoMail areas  is
  1365.                   only supported  by a few programs and it is not legal to
  1366.                   send them in normal EchoMail  areas.
  1367.                   Configure an EchoMail Area as a File Echo  only  if  you
  1368.                   are  sure that File Attaches  are allowed in that  area.
  1369.  
  1370.       BAD       - Bad Area.  You  have  to  configure one and only one Bad
  1371.                   Area.
  1372.  
  1373.  
  1374.       1.8.1.1  System
  1375.  
  1376.        1.8.1.1.1  Name
  1377.  
  1378.          In  this  string  gadget  you  can insert the Area Name that Mail
  1379.          Manager will show you in the Areas List of the Areas Window.  You
  1380.          can  also  use  the same control characters used for the PreParse
  1381.          Strings. This is a compulsory field.
  1382.  
  1383.  
  1384.        1.8.1.1.2  Desc
  1385.  
  1386.          In  this  string gadget you can insert a long description for the
  1387.          Area.  Mail Manager does not use this field, but it could be read
  1388.          from ARexx, normally a Full  Node will insert a string here which
  1389.          will be returned as Area Description by AreaFix.
  1390.  
  1391.  
  1392.        1.8.1.1.3  Path
  1393.  
  1394.          In this string gadget you can insert the path of the Primary Area
  1395.          Directory.   This  is the directory where Mail Manager will store
  1396.          the Message Base of the Area.  This is a compulsory field.
  1397.  
  1398.  
  1399.        1.8.1.1.4  AltPath
  1400.  
  1401.          In  this  string  gadget you can insert the path of the Alternate
  1402.          Area  Directory.   Mail  Manager  normally uses this directory to
  1403.          store  File  Attaches  in NetMail and File Echo Areas.  If you do
  1404.          not  specify  an Alternate Area Directory Mail Manager will store
  1405.          File Attaches in the Primary Area Directory.
  1406.  
  1407.  
  1408.        1.8.1.1.5  UserFlags
  1409.  
  1410.          In  this  string  gadget you can insert every kind of information
  1411.          about  the  Area.   Mail  Manager does not use this field, but it
  1412.          could  be  read  from  ARexx  so you could use it to store useful
  1413.          information for ARexx scripts.
  1414.  
  1415.  
  1416.        1.8.1.1.6  Address
  1417.  
  1418.          Here you can select the Address you want to use in the Area.
  1419.          In EchoMail Areas this will be the address inserted in the Origin
  1420.          line.
  1421.          In  NetMail Areas this will be the address inserted by default in
  1422.          the  From  Address string gadget of the Message parameters Window
  1423.          when you write a message.  Normally you don't have to worry about
  1424.          the  contents  of  this  gadget, During the export operation Mail
  1425.          Manager  will  scan  the  configured  Addresses  (  Akas won't be
  1426.          scanned  ) and will automatically choose the right one ( normally
  1427.          the nearest to the destination address ).
  1428.  
  1429.  
  1430.        1.8.1.1.7  Group
  1431.  
  1432.          Here  you can select the group the area belongs to and the access
  1433.          level required for the area.  This is only really useful for Full
  1434.          Nodes  which  use this information mainly for AreaFix. Anyway,  a
  1435.          simple Point could use this to group together some areas with the
  1436.          same characteristics. If you do not need Groups, you can define a
  1437.          single group and link all the areas to this group.
  1438.  
  1439.  
  1440.  
  1441.       1.8.1.2  Nodes
  1442.  
  1443.         From  here  you  can  link/unlink the configured Nodes to/from the
  1444.         selected Area.
  1445.  
  1446.  
  1447.  
  1448.       1.8.1.3  Texts
  1449.  
  1450.         Here you can select the Sysop name, the Prologue, the Logo and the
  1451.         Origin you want to use in the Area.
  1452.  
  1453.  
  1454.  
  1455.       1.8.1.4  Misc
  1456.  
  1457.        1.8.1.4.1  Read Only
  1458.  
  1459.          If you set this CheckMark you cannot write messages in this area.
  1460.  
  1461.  
  1462.        1.8.1.4.2  Two pass Import
  1463.  
  1464.          If  you  set this CheckMark, messages imported in this Area won't
  1465.          be  automatically exported during the Import operation.  You will
  1466.          have to launch the Export operation on the area after the Import.
  1467.          This is useful if  you want to perform some additional operations
  1468.          on  imported messages before exporting them. Normally Full  Nodes
  1469.          will  have  to set their Netmail  Areas as  'Two Pass Import'  in
  1470.          order  to  process the imported messages with their  AreaFix  and
  1471.          Message Tracker scripts before exporting the messages.
  1472.  
  1473.  
  1474.        1.8.1.4.3  CharSet
  1475.  
  1476.          Here you can configure the CharSets used in the Area.
  1477.          The  Read  cycle  gadget  defines the default Charset assumed for
  1478.          messages without a CHRS kludge.
  1479.          The  Write  cycle gadget defines the Charset used for reading and
  1480.          writing messages.
  1481.  
  1482.  
  1483.        1.8.1.4.4  Delete By
  1484.  
  1485.          Here you can define the  method used for the Delete operation and
  1486.          the  minimum  number of messages  left in the Area after a Delete
  1487.          operation.
  1488.  
  1489.  
  1490.        1.8.1.4.5  Font
  1491.  
  1492.          Here  you can select the Font used when reading messages in  this
  1493.          Area.
  1494.  
  1495.  
  1496.        1.8.1.4.6  Msgbase
  1497.  
  1498.          Here you can select the type of Message Base used for the Area.
  1499.  
  1500.          Plain      - This is the standard Fidonet message base.  One file
  1501.                       for  every  message.   Really  really  slow,  almost
  1502.                       useless, but it is the standard.
  1503.          Indexed    - Stores  the messages in the same format of the Plain
  1504.                       message base,  but it also keeps an index of all the
  1505.                       messages  in the area.  This speeds things really up
  1506.                       and, at the same time, adheres to the standards.
  1507.          Quick      - Only  two files  per area, one with all the messages
  1508.                       and one with an index.  Really really fast.
  1509.          Compressed - Same  format as the Quick message base, but the body
  1510.                       of the messages is compressed.  The compression rate
  1511.                       is about 30%, but on fast machines it is faster than
  1512.                       the Quick message base !!!
  1513.  
  1514.          The  Plain  and  Indexed  message  bases can be shared with other
  1515.          programs.
  1516.  
  1517.  
  1518.        1.8.1.4.7  Show
  1519.  
  1520.          Here you can configure the initial state of the Show cycle gadget
  1521.          of the Area.
  1522.  
  1523.  
  1524.        1.8.1.4.8  Sort
  1525.  
  1526.          Here you can configure the initial state of the Sort cycle gadget
  1527.          of the Area.
  1528.  
  1529.  
  1530.  
  1531.     1.8.2  Ticks
  1532.  
  1533.       Here  you can insert all the Tick  Areas you want to manage on  your
  1534.       system.
  1535.       In  the  Tag  string gadget you can insert the TAG-name of the area.
  1536.       You cannot use the same TAG-name for two different Tick Areas.
  1537.  
  1538.  
  1539.       1.8.2.1  System
  1540.  
  1541.        1.8.2.1.1  Desc
  1542.  
  1543.          In  this  string gadget you can insert a long description for the
  1544.          Area.  Mail Manager does not use this field, but it could be read
  1545.          from  ARexx. Normally Full Nodes will insert a string here  which
  1546.          will be returned as Area Description by AreaFix.
  1547.  
  1548.  
  1549.        1.8.2.1.2  Path
  1550.  
  1551.          In this string gadget you can insert the path of the Primary Area
  1552.          Directory.   This  is the directory where Mail Manager will store
  1553.          the  Tick Files hatched in the Area. This is a compulsory  field.
  1554.  
  1555.  
  1556.        1.8.2.1.3  AltPath
  1557.  
  1558.          In  this  string  gadget you can insert the path of the Alternate
  1559.          Area  Directory.   Mail  Manager  does not use this field, but it
  1560.          could be read from ARexx.
  1561.  
  1562.  
  1563.        1.8.2.1.4  UserFlags
  1564.  
  1565.          In  this  string  gadget you can insert every kind of information
  1566.          about  the  Area.   Mail  Manager does not use this field, but it
  1567.          could  be  read  from  ARexx  so you could use it to store useful
  1568.          information for ARexx scripts.
  1569.  
  1570.  
  1571.        1.8.2.1.5  Address
  1572.  
  1573.          Here you can select the Address you want to use in the Area.
  1574.  
  1575.  
  1576.        1.8.2.1.6  Group
  1577.  
  1578.          Here  you can select the group the area belongs to and the access
  1579.          level required for the area.  This is only really useful for Full
  1580.          Nodes  which  use this information mainly for AreaFix.  Anyway, a
  1581.          simple Point could use this to group together some areas with the
  1582.          same characteristics. If you do not need Groups, you can define a
  1583.          single group and link all the areas to this group.
  1584.  
  1585.  
  1586.  
  1587.       1.8.2.2  Nodes 
  1588.  
  1589.         From  here  you  can  link/unlink the configured Nodes to/from the
  1590.         selected Area.
  1591.  
  1592.  
  1593.  
  1594.       1.8.2.3  Tick Commands
  1595.  
  1596.         Here you can select the Tick Command you want to use in the Area.
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604. 2  MAIL MANAGER GRAPHICAL USER INTERFACE
  1605.  
  1606.   Mail  Manager  Graphical User Interface deeply uses the features of MUI.
  1607.   With  MUI  you  can configure almost everything of the Mail Manager GUI,
  1608.   besides  you  can  control  everything  with  the mouse or even with the
  1609.   keyboard.  In order to completelly exploit such a powerful interface you
  1610.   SHOULD read MUI's documentation carefully.
  1611.  
  1612.  
  1613.   2.1  Areas Window
  1614.  
  1615.  
  1616.     2.1.1  Areas List
  1617.  
  1618.       Here MM shows some information about the areas:
  1619.  
  1620.       AreaName - Is the name of the area
  1621.       Tot      - Is the total number of messages present in the area
  1622.       New      - Is the number of UnRead messages in the area
  1623.       Sys      - Is the number of UnRead messages addressed  to you in the
  1624.                  area
  1625.       Unr      - Is the number of UnReplied messages  addressed  to you in
  1626.                  the area
  1627.       Imp      - Is the number of messages tossed into the area during the
  1628.                  last import
  1629.       HiMsg    - Is the number of the last message in the Area
  1630.       Type     - Is the type of the area ( Mail / Echo / FEcho / Bad )
  1631.       MBase    - Is the type of message base used in the area
  1632.                  ( PThro / Plain / Idx / Quick / Comp )
  1633.       NDel     - Is  the  minimum  number  of  messages left by MM after a
  1634.                  Delete operation
  1635.       Flags    - Here MM shows some other information
  1636.                  1 flag : Sorting method used for the delete operation
  1637.                           ( N=Number  D=Date )
  1638.                  2 flag : Sorting method used in the Messages Window
  1639.                           ( N=Number  D=Date  F=From  T=To  S=Subject )
  1640.                  3 flag : Read Only Flag ( R=Read Only area)
  1641.                  4 flag : Area Status  ( S=Scanned )
  1642.                  5 flag : Export Flag ( E=Area contains UnSent messages )
  1643.  
  1644.       You  can 100% rely on this information only if you have just scanned
  1645.       the area.
  1646.  
  1647.       If you single click on an area, you select that area,  if you double
  1648.       click on an area, you will enter in that area. Of course you can use
  1649.       all the configured keyboard shortcuts for a MUI listview.
  1650.  
  1651.  
  1652.  
  1653.     2.1.2  Areas Management
  1654.  
  1655.  
  1656.       2.1.2.1  All
  1657.  
  1658.         Selects All the areas showed in the Areas List.
  1659.  
  1660.  
  1661.  
  1662.       2.1.2.2  None
  1663.  
  1664.         UnSelects All the selected areas showed in the Areas List.
  1665.  
  1666.  
  1667.  
  1668.       2.1.2.3  Import
  1669.        
  1670.         Launches the Import function.
  1671.     
  1672.         MM looks in your inbound directory for mail packets and bundles.
  1673.  
  1674.         If  you  have  set 'Do BackUp' it makes also a copy of packets and
  1675.         bundles in the configured BackUp Directory.
  1676.  
  1677.         In   case   of  bundles,  MM  recognizes  the  used  archiver  and
  1678.         automatically unpacks the bundles in the configured Work Directory.
  1679.  
  1680.         Then  MM  reads the message from the packet, exports it and tosses
  1681.         it  into the appropriate echo or mail area.  If you do not want to
  1682.         simultaneously  import  and  export a message ( for example if you
  1683.         want  to  launch  a filter or a msgtracker before exporting a just
  1684.         imported message ) you have to set 'TwoPassImport' for the area.
  1685.  
  1686.         Before  and  after  every  import  operation  MM  tries  to rescue
  1687.         Temporary Flow files and Orphan Packets.  Temporary Flow files are
  1688.         generated  when  the  main  Flow  file for a node is locked and MM
  1689.         cannot  write in it.  Orphan Packets are normally generated when a
  1690.         guru happens while MM is performing an Import/Export Operation.
  1691.  
  1692.  
  1693.  
  1694.       2.1.2.4  Export
  1695.        
  1696.         Launches the Export function.
  1697.         If there are any selected areas, MM will only process those areas,
  1698.         otherwise  it will process all the  areas  or,  if  you  have  set
  1699.         'Smart Export', only areas with UnSent messages.
  1700.  
  1701.         MM looks into the areas for UnSent messages.  When it finds one it
  1702.         behaves  differently  if  the area is a NetMail one or an EchoMail
  1703.         one.
  1704.  
  1705.         In  case  of  a  NetMail area, it reads the origin and destination
  1706.         addresses and:
  1707.         -  If the destination address is one of your Addresses or Akas, MM
  1708.            flags  the  message as Sent, updates some kludges and stops the
  1709.            message.
  1710.         -  If  the  origin address is one of your Addresses or Akas and it
  1711.            is  flagged  as  Hold or as Crash, MM inserts it in an outgoing
  1712.            packet for the destination node with the proper flavor.
  1713.         -  If  you  are  a node and the destination address is one of your
  1714.            listed points, MM inserts the message in an outgoing packet for
  1715.            the point with the flavor specified for the point.
  1716.         -  In all the other cases it follows the Routing statements.
  1717.  
  1718.         In  case  of  an  EchoMail area,  it  parses the Seen-By lines and
  1719.         inserts  the message into an outgoing packet for every node linked
  1720.         to  the area that is not already listed in the Seen-By lines.  The
  1721.         flavor  of  the  packet  will be the one you have specified in the
  1722.         corresponding Node configuration.  MM never sends the message back
  1723.         to  the  node  that  has  sent  it to you, even if the node is not
  1724.         listed in the Seen-By lines.
  1725.  
  1726.  
  1727.         During  the export operation MM also manages File Attaches.  MM is
  1728.         able to manage both NetMail and EchoMail file attached:
  1729.  
  1730.         NetMail  file  attaches  are  managed  only  if one or more of the
  1731.         following conditions are satisfied:
  1732.         -  The  origin or the destination address of the message is one of
  1733.            your Addresses/Akas.
  1734.         -  The  destination  address  of the message is one of your listed
  1735.            points
  1736.         -  The  origin  and  destination addresses of the message are both
  1737.            listed on your system.
  1738.  
  1739.         EchoMail file attached are managed only if you have configured the
  1740.         area as 'File Echo'.
  1741.  
  1742.         When  MM  manages  file attaches, it makes a copy of the file into
  1743.         the directory you have specified as 'AltPath' for the area ( or in
  1744.         the  area  directory if you have not specified an 'AltPath' ), and
  1745.         then  inserts  its filename into the flow file for the destination
  1746.         node(s).   If the origin address of the message is not one of your
  1747.         Addresses/Akas, the file will be deleted from the Inbound dir.
  1748.         An  attached file  inherits  its  flavor  from  the  message it is
  1749.         attached to.
  1750.  
  1751.  
  1752.  
  1753.       2.1.2.5  Scan
  1754.        
  1755.         Launches the Scan function.
  1756.         If  there are selected areas, MM scans only those areas, otherwise
  1757.         it scans all the areas.
  1758.  
  1759.         MM  scans the message base looking for messages, building an index
  1760.         of the area in memory.
  1761.  
  1762.         MM supports four different types of message bases:
  1763.         Plain      - This is the  standard Fidonet message base.  One file
  1764.                      for   every  message.   Really  really  slow,  almost
  1765.                      useless, but it is the standard.
  1766.         Indexed    - Stores  the  messages in the same format of the Plain
  1767.                      message  base,  but it keeps also an index of all the
  1768.                      messages  in  the area.  This speeds things really up
  1769.                      and, at the same time, keeps the standards.
  1770.         Quick      - Only  two  files  per area, one with all the messages
  1771.                      and one with an index.  Really really fast.
  1772.         Compressed - Same  format  of the Quick message base, but the body
  1773.                      of  the messages is compressed.  The compression rate
  1774.                      is  about 30%, but on fast machines it is faster than
  1775.                      the Quick message base !!!
  1776.  
  1777.  
  1778.         The  Plain  and  Indexed  message  bases  can be shared with other
  1779.         programs.
  1780.  
  1781.         When  MM  scans an area, it is able to understand if something has
  1782.         modified its message base.  If the area index is already in memory
  1783.         the  area  will be scanned again only if it has been modified from
  1784.         an external program.
  1785.         Of  course MM automatically performs a scan before executing every
  1786.         other operation on an area.
  1787.  
  1788.  
  1789.  
  1790.       2.1.2.6  Free
  1791.        
  1792.         Launches the Free function.
  1793.         If  there are selected areas, MM frees only those areas, otherwise
  1794.         it frees all the areas.
  1795.  
  1796.         Frees the memory used for keeping the index of a scanned area.  If
  1797.         the message base of the area is not Plain it also writes the index
  1798.         on the disk.
  1799.         MM  automatically  tries  to  free  some areas when it reaches the
  1800.         configured 'Min Free Mem' value.
  1801.         Of course Mail Manager automatically frees all the areas everytime
  1802.         you quit it.
  1803.  
  1804.  
  1805.  
  1806.       2.1.2.7  Update
  1807.        
  1808.         Launches the Update function.
  1809.         If  there  are  selected  areas,  MM  updates  only  those  areas,
  1810.         otherwise it updates all the areas.
  1811.  
  1812.         Writes  on disk the index of the area, but continues to keep it in
  1813.         memory.
  1814.         Of course it is completelly useless on a Plain message base.
  1815.  
  1816.  
  1817.  
  1818.       2.1.2.8  Optimize
  1819.        
  1820.         Launches the Optimize function on the selected areas.
  1821.  
  1822.         Optimizes the message base in Quick or Compressed areas.
  1823.     The  Optimize  function  is  automatically performed at the end of
  1824.         every  Delete  operation,  anyway  it  is  always  a  good idea to
  1825.         manually perform it once in a while.
  1826.         When  you  modify a message ( for example when you edit, delete or
  1827.         even  export  it  )  in  a Quick or Compressed area the disk space
  1828.         associated  with  the  old  version  of the message won't be freed
  1829.         immediatelly.  You will have to optimize the area in order to free
  1830.         the  unused  disk  space  and  to  reorganize  the message base as
  1831.         efficiently as possible.  It also renumbers the area.
  1832.         Of  course  this  function  is  completelly  useless  on Plain and
  1833.         Indexed message bases.
  1834.  
  1835.  
  1836.  
  1837.       2.1.2.9  Delete
  1838.        
  1839.         Launches the Delete function on the selected areas.
  1840.  
  1841.         Deletes  messages from the area.  It follows the DeleteBy settings
  1842.         for  the  area.   You  can  protect a message from the deletion by
  1843.         setting the 'Protected' message flag.
  1844.         If you have set 'Keep Sysop', messages written or addressed to you
  1845.         won't be deleted.
  1846.  
  1847.  
  1848.  
  1849.       2.1.2.10  Purge
  1850.        
  1851.         Launches the Purge function on the selected areas.
  1852.  
  1853.         Performs  the  same operations as the Delete function, but it does
  1854.         not delete UnRead messages.
  1855.  
  1856.  
  1857.  
  1858.       2.1.2.11  Show
  1859.        
  1860.         This Cycle gadget selects the type of areas that will be showed in
  1861.         the Areas List.
  1862.  
  1863.         All  - Shows all the areas.
  1864.         Tot  - Shows only areas which contain messages.
  1865.         New  - Shows only areas which contain UnRead messages.
  1866.         Sys  - Shows only areas which contain UnRead messages addressed to
  1867.                you.
  1868.         Unr  - Shows only areas which contain UnReplied messages addressed
  1869.                to you.
  1870.         Imp  - Shows only areas which contain messages imported during the
  1871.                last import.
  1872.         Echo - Shows only EchoMail areas
  1873.         Mail - Shows only NetMail areas
  1874.  
  1875.         You  can  configure  the  initial  state  of  this gadget with the
  1876.         Areas List 'Show' configuration parameter.
  1877.  
  1878.         Remember  that  also  the status of the  Domains menu could affect
  1879.         the number of areas showed in the Areas List.
  1880.  
  1881.  
  1882.  
  1883.       2.1.2.12  Sort
  1884.        
  1885.         This  Cycle  gadget  selects  the sorting method used in the Areas
  1886.         List.
  1887.  
  1888.         Config      - Sorts  areas in the same order as they are described
  1889.                       in the configuration file.
  1890.         Alphabetic  - Sorts areas in alphabetical order of their name
  1891.         Groups      - Sorts areas in alphabetical order of their group
  1892.         Number Tot  - Sorts   areas   by  the  total  number  of  messages
  1893.                       contained in the area
  1894.         Number New  - Sorts   areas   by  the  number  of  UnRead messages
  1895.                       contained in the area
  1896.         Number Sys  - Sorts   areas   by  the  number  of  UnRead messages
  1897.                       addressed to you contained in the area
  1898.         Number Unr  - Sorts  areas  by the  number  of  UnReplied messages
  1899.                       addressed to you contained in the area
  1900.         Number Imp  - Sorts   areas   by  the  number of messages imported
  1901.                       during the last import
  1902.  
  1903.         You  can  configure  the  initial  state  of  this gadget with the
  1904.         Areas List 'Order' parameter.
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.     2.1.3  Areas Menus
  1911.  
  1912.  
  1913.       2.1.3.1  Project
  1914.  
  1915.  
  1916.         2.1.3.1.1  About
  1917.  
  1918.           Shows some information about Mail Manager.
  1919.  
  1920.  
  1921.  
  1922.         2.1.3.1.1  Quit
  1923.  
  1924.           Quits  Mail  Manager.
  1925.           You can also quit Mail Manager by closing the Areas Window ( MUI
  1926.           allows  you to configure a shortcut also for closing a window ).
  1927.           In  this last case Mail Manager will open a requester asking you
  1928.           to confirm the operation.
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.       2.1.3.2  Configuration
  1935.  
  1936.  
  1937.         2.1.3.2.1  Edit
  1938.  
  1939.           Calls  MM_Prefs  allowing  you  to edit your actual Mail Manager
  1940.           configuration.  MM_Prefs should be located in MM:Bin/.
  1941.  
  1942.  
  1943.  
  1944.         2.1.3.2.2  Load...
  1945.  
  1946.           Opens  a  file  requester  allowing  you  to select a particular
  1947.           configuration file to load.
  1948.  
  1949.  
  1950.  
  1951.         2.1.3.2.3  Save
  1952.  
  1953.           Saves  the  actual  configuration with the same file name it has
  1954.           been loaded.
  1955.  
  1956.  
  1957.  
  1958.         2.1.3.2.4  Save As...
  1959.  
  1960.           Opens a file requester allowing you to select the file name with
  1961.           which the actual configuration will be saved.
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.       2.1.3.3  Ticks
  1968.  
  1969.  
  1970.         2.1.3.3.1  Import
  1971.  
  1972.         Launches the Ticks Import function.
  1973.     
  1974.         MM looks in your inbound directory for .TIC files.
  1975.         Then MM reads and parses them.  If everything is OK it imports the
  1976.         corresponding   file.    Mail   Manager   performs  the  following
  1977.         operations:
  1978.         - If there is a file to replace, MM deletes the file from the area
  1979.         - it copies the file into the directory specified as Area Path.
  1980.         - it inserts the description of the file inside the file comment.
  1981.     Then  if  you  have configured a TickCommand for the Area, MM will
  1982.         launch the configured command.
  1983.     If  everything  is  OK  it will export the Tick file to the linked
  1984.         nodes  and  will  delete the .Tic and the associated file from the
  1985.         Inbound dir.
  1986.  
  1987.  
  1988.  
  1989.         2.1.3.3.2  Hatch
  1990.  
  1991.     Allows you to insert a file into a Tick Area.
  1992.     When  you  press  the  OK  gadget  it  will  launch  the following
  1993.         operations:
  1994.         - If there is a file to replace, MM deletes the file from the area
  1995.         - it copies the file into the directory specified as Area Path.
  1996.         - it inserts the description of the file inside the file comment.
  1997.     Then  if  you  have configured a TickCommand for the Area, MM will
  1998.         launch the configured command.
  1999.         If  everything  is  OK  it will export the Tick file to the linked
  2000.         nodes.
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.       2.1.3.4  Miscellaneous
  2007.  
  2008.  
  2009.         2.1.3.4.1  File Request
  2010.  
  2011.           Opens  the  MM  File Request window.  In the Node gadget you can
  2012.           enter  the node address from which you would like to request the
  2013.           files.  If the node is listed on your system you can also select
  2014.           it from  the associated popup.  Then you can enter the filenames
  2015.           in the string gadget below the listview.
  2016.           To  delete  a  file  just select it from the listview, clear the
  2017.           string gadget and press enter.
  2018.           If  a  requested  file  is  already present in the .REQ file, it
  2019.           won't be added again.
  2020.  
  2021.  
  2022.  
  2023.         2.1.3.4.2  Area Statistics
  2024.  
  2025.           Displays some useful information about the selected areas.
  2026.  
  2027.  
  2028.  
  2029.         2.1.3.4.3  Renumber
  2030.  
  2031.           Launches the Renumber function on the selected areas.
  2032.  
  2033.           It renumbers only areas in Plain or Indexed message bases; areas
  2034.           in   Quick   and  Compressed  message  bases  are  automatically
  2035.           renumbered during the Optimize function.
  2036.           You  have  to  renumber  an area only if the message numbers are
  2037.           becoming  really  high  (  the maximum message number allowed in
  2038.           Fidonet standards is 65535 ), otherwise there is no valid reason
  2039.           for renumbering an area.
  2040.           This  function  does  not  update the link fields of the message
  2041.           header.   This  field  is set by MM during import, but MM itself
  2042.           does  not  really  use  it.   Nevertheless it is used from other
  2043.           programs,  for  example  from  DLG, so DLG users should renumber
  2044.           their   message  bases  only  with  the  DLG  internal  Renumber
  2045.           function.
  2046.  
  2047.  
  2048.  
  2049.         2.1.3.4.4  Convert Message Base
  2050.  
  2051.           Converts the Message Base of an area from one type to another.
  2052.  
  2053.  
  2054.  
  2055.         2.1.3.4.5  Deep Scan
  2056.  
  2057.           Launches the Deep Scan function on the selected areas.
  2058.  
  2059.           Performs  the  same  operations  of  the  Scan  function, but it
  2060.           ignores  the  indexes written on disk.  It is really much slower
  2061.           than the Scan operation, and it is useful only if you think that
  2062.           there is something wrong in the index file.
  2063.           MM  automatically  switches  from  Scan  to  Deep  Scan  when it
  2064.           understands  that  the  index  file  of  an  area is wrong ( for
  2065.           example  when an external program has modified the message base,
  2066.           making the index outdated ).
  2067.           Of course it is completely useless on a Plain message base.
  2068.  
  2069.  
  2070.  
  2071.         2.1.3.4.6  Write Stats
  2072.  
  2073.           Updates the statistics file.
  2074.           Mail Manager automatically updates the statistics file everytime
  2075.           you quit or iconify it.
  2076.  
  2077.  
  2078.  
  2079.         2.1.3.4.7  Restore Bad
  2080.     
  2081.           Restores  messages tossed into the bad area because the original
  2082.           area  did  not  exist when they were imported (such messages are
  2083.           flagged  as  UNKNWAREA),  or  because the node is unknown or not
  2084.           linked to the area ( flagged as UNLNKNODE ).  Of course messages
  2085.           flagged as UNKNWAREA will be restored only if, in the mean time,
  2086.           you have created the area.
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.       2.1.3.5  Domains
  2093.  
  2094.         This menu lists all the domains you have configured.
  2095.         With  this menu you can include or exclude from the areas list all
  2096.         the areas that belong to a particular domain.
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.       2.1.3.6  User
  2103.  
  2104.         This   menu  lists  all  the  user  definable  commands  you  have
  2105.         configured  as  Custom Areas Commands.  When you select one of its
  2106.         items  the  associated  command will be launched with the AmigaDOS
  2107.         'Run' command.
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.   2.2  Messages Window
  2115.  
  2116.  
  2117.     2.2.1  Messages List
  2118.  
  2119.       Here MM shows some information about the messages in the area:
  2120.  
  2121.       Num      - Is the number of the message
  2122.       Date     - Is the creation date of the message
  2123.       From     - Is the name of the sender of the message
  2124.       To       - Is the name of the addressee of the message
  2125.       Subj     - Is the subject of the message
  2126.       Flags    - Here MM shows some other information
  2127.                  1 flag : (U) UnReplied flag.   The  message  is UnReplied
  2128.                               and addressed to you
  2129.                  2 flag : (S) Sysop flag.    The  message  is  UnRead  and
  2130.                               addressed to you
  2131.                  3 flag : (N) New flag.  The message is UnRead
  2132.                  4 flag : (I) Imported flag. The message has been imported
  2133.                               ( it has not been written on your system ).
  2134.                  5 flag : (S) Sent flag.  The message has been exported.
  2135.                  6 flag : (M) Marked flag.   Useful for flagging a message
  2136.                               for you own purposes.
  2137.                  7 flag : (P) Protected flag.   The  message is  protected
  2138.                               from deletion.
  2139.                  8 flag : (D) Deleted flag.   The  message is  flagged for
  2140.                               deletion.
  2141.  
  2142.       If you single click on an message,  you select that message,  if you
  2143.       double click on an message,  you will read that message.   Of course
  2144.       you can use all the configured keyboard shortcuts for a MUI listview.
  2145.  
  2146.  
  2147.  
  2148.  
  2149.     2.2.2  Messages Management
  2150.  
  2151.  
  2152.       2.2.2.1  All
  2153.  
  2154.         Selects All the messages showed in the Messages List.
  2155.  
  2156.  
  2157.  
  2158.       2.2.2.2  None
  2159.  
  2160.         UnSelects All the selected messages showed in the Messages List.
  2161.  
  2162.  
  2163.  
  2164.       2.2.2.3  Search
  2165.  
  2166.         Opens the Search Messages window.
  2167.         You  can  insert  a  different  search  pattern ( All the AmigaDOS
  2168.         WildCard are allowed ) in every string gadget.
  2169.         The 'Case' cycle gadget allows you to choose if the Search will be
  2170.         case sensitive or insensitive, the 'Match' cycle gadget allows you
  2171.         to  choose  if  the  messages  should simultaneously match all the
  2172.         entered patterns or if it enough to match a single pattern.
  2173.         When you press 'Ok' Mail Manager will select all the messages that
  2174.         satisfy the above conditions.
  2175.  
  2176.  
  2177.  
  2178.       2.2.2.4  Flags
  2179.  
  2180.         Opens the Message Flags window.
  2181.         It allows you to set or clear the flags of the selected messages.
  2182.         It also allows you to select messages with a particular flag set.
  2183.  
  2184.  
  2185.  
  2186.       2.2.2.5  R News
  2187.  
  2188.         Changes  the  Show cycle gadget status to 'New' and starts reading
  2189.         the first UnRead message.
  2190.  
  2191.  
  2192.  
  2193.       2.2.2.6  R Slct
  2194.  
  2195.         Changes  the  Show  cycle  gadget  status to 'Selected' and starts
  2196.         reading  the first Selected message.
  2197.         Useful,  for  example,  if  you  want  to  read  all  the messages
  2198.         selected with the Search or Flags functions.
  2199.  
  2200.  
  2201.  
  2202.       2.2.2.7  Write
  2203.  
  2204.         Calls  the  configured  Text  Editor  allowing  you to write a new
  2205.         message  in  the current area.  As soon as you close the editor it
  2206.         opens  the  Message  Parameters  Window allowing you to insert the
  2207.         Message Parameters.
  2208.  
  2209.  
  2210.  
  2211.       2.2.2.8  Forward
  2212.  
  2213.         Allows  you  to  forward  the  active message to another area.  It
  2214.         opens  a  requester allowing you to select the area where you want
  2215.         to  forward the message.  It then calls the configured Text Editor
  2216.         allowing you to edit the message.  As soon as you close the editor
  2217.         it  opens  the  Message Parameters Window allowing you to edit the
  2218.         Message Parameters.
  2219.  
  2220.  
  2221.  
  2222.       2.2.2.9  Edit
  2223.  
  2224.         Allows you to modify an existing message.  It calls the configured
  2225.         Text  Editor  allowing you to edit the text of the active message.
  2226.         As  soon  as  you close the editor it opens the Message Parameters
  2227.         Window allowing you to edit the Message Parameters.
  2228.  
  2229.  
  2230.  
  2231.       2.2.2.10  Edit Hdr
  2232.  
  2233.         Allows  you to modify the header of an existing message.  It opens
  2234.         the  Message Parameters Window allowing you to edit the parameters
  2235.         of the active message.
  2236.  
  2237.  
  2238.  
  2239.       2.2.2.11  Reply
  2240.  
  2241.         Allows  you  to  reply  to  the  active message.  It reformats and
  2242.         quotes  the message,  next  it  calls  the  configured Text Editor
  2243.         allowing you to type your reply.
  2244.         As  soon  as  you close the editor it opens the Message Parameters
  2245.         Window allowing you to edit the Message Parameters.
  2246.  
  2247.  
  2248.  
  2249.       2.2.2.12  X Reply
  2250.  
  2251.         Performs the same operations as the Reply function, but it opens a
  2252.         requester  allowing  you to select the area where you want to post
  2253.         your reply.
  2254.  
  2255.  
  2256.  
  2257.       2.2.2.13  Show
  2258.        
  2259.         This Cycle gadget selects the type of messages that will be showed
  2260.         in the Messages List.
  2261.  
  2262.         All       - Shows all the messages.
  2263.         New       - Shows only UnRead messages.
  2264.         Sysop     - Shows only UnRead messages addressed to you.
  2265.         UnRepl    - Shows only UnReplied messages addressed to you.
  2266.         Last Imp  - Shows only messages imported during the last import.
  2267.         Selected  - Shows only selected messages.
  2268.  
  2269.         You  can  configure  the  initial  state  of  this gadget with the
  2270.         Show parameter in the Messages Areas configuration.
  2271.  
  2272.  
  2273.  
  2274.       2.2.2.14  Sort
  2275.        
  2276.         This  Cycle gadget selects the sorting method used in the Messages
  2277.         List.
  2278.  
  2279.         Number   - Sorts messages by their number
  2280.         Date     - Sorts messages by their creation date
  2281.         From     - Sorts messages by alphabetical order of their sender
  2282.         To       - Sorts messages by alphabetical order of their addressee
  2283.         Subject  - Sorts messages by alphabetical order of their subject
  2284.  
  2285.         You  can  configure  the  initial  state  of  this gadget with the
  2286.         SortBy parameter in the Messages Areas configuration.
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.     2.2.3  Messages Menus
  2293.  
  2294.  
  2295.       2.2.3.1  Messages
  2296.  
  2297.  
  2298.         2.2.3.1.1  Delete
  2299.  
  2300.           Toggles the status of the Deleted Flag of the selected messages.
  2301.  
  2302.  
  2303.  
  2304.         2.2.3.1.2  Protect
  2305.  
  2306.           Toggles the status of the Protected Flag of the selected messages.
  2307.  
  2308.  
  2309.  
  2310.         2.2.3.1.3  Mark
  2311.  
  2312.           Toggles the status of the Marked Flag of the selected messages.
  2313.  
  2314.  
  2315.  
  2316.         2.2.3.1.4  Archive
  2317.  
  2318.           Opens a file requester allowing you to select the file where you
  2319.           want to save the selected messsages.
  2320.           You  can  configure  the  default  name  of  the  file  with the
  2321.           'Archive File' parameter.
  2322.  
  2323.  
  2324.  
  2325.         2.2.3.1.5  Print
  2326.  
  2327.           Prints the selected messages on the configured printer.
  2328.  
  2329.  
  2330.  
  2331.         2.2.3.1.6  Toggle UnReplied Flag
  2332.  
  2333.           Toggles the status of the UnReplied Flag of the selected messages.
  2334.  
  2335.  
  2336.  
  2337.  
  2338.       2.2.3.2  Miscellaneous
  2339.  
  2340.  
  2341.         2.2.3.2.1  File Request
  2342.  
  2343.           Opens  the  MM  File Request window.  In the Node gadget you can
  2344.           enter  the node address from which you would like to request the
  2345.           files.  If the node is listed on your system you can also select
  2346.           it from the associated popup.  Then you can enter the file names
  2347.           in the string gadget below the listview.
  2348.           To  delete  a  file  just select it from the listview, clear the
  2349.           string gadget and press enter.
  2350.           If  a  requested  file  is  already present in the .REQ file, it
  2351.           won't be added again.
  2352.  
  2353.  
  2354.  
  2355.         2.2.3.2.2  Areas Window
  2356.  
  2357.           Goes Back to the Areas Window
  2358.  
  2359.  
  2360.  
  2361.         2.2.3.2.3  Areas List
  2362.  
  2363.           Opens a requester allowing you to select the area where you want
  2364.           to go.
  2365.  
  2366.  
  2367.  
  2368.         2.2.3.2.4  Previous Area
  2369.  
  2370.           Goes to the previous area.
  2371.  
  2372.  
  2373.  
  2374.         2.2.3.2.5  Next Area
  2375.  
  2376.           Goes to the next area.
  2377.  
  2378.  
  2379.  
  2380.         2.2.3.2.6  Previous UnRead Area
  2381.  
  2382.           Goes to the previous area with unread messages.
  2383.  
  2384.  
  2385.  
  2386.         2.2.3.2.7  Next UnRead Area    
  2387.  
  2388.           Goes to the next area with unread messages.
  2389.  
  2390.  
  2391.  
  2392.         2.2.3.2.8  Export Area
  2393.  
  2394.           Performs an export of the current area.
  2395.  
  2396.  
  2397.  
  2398.  
  2399.       2.2.3.3  User
  2400.  
  2401.         This is a copy of the User Menu of the Areas Window.
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.   2.3  Browse Window
  2411.  
  2412.  
  2413.     2.3.1  Browse Window Gadgets
  2414.  
  2415.  
  2416.       2.3.1.1  Threads
  2417.  
  2418.         Opens  the  Threads window.  In this window Mail Manager shows you
  2419.         the reply thread of the current message.
  2420.         Mail Manager has a really powerful reply thread management.  It is
  2421.         able  to  link messages on Subject or on MSGID/REPLY kludges.  You
  2422.         can  change  the  type  of linking with the cycle gadget below the
  2423.         listview.  In the listview Mail Manager shows you all the messages
  2424.         that  belong to the thread.  For every message it shows the status
  2425.         of the New flag, the name of the Sender, the name of the Adrressee
  2426.         and the message number.
  2427.         The  entry  corresponding  to  the  Current  Message ( the message
  2428.         showed  in the Browse window ) is the one with the ListView cursor
  2429.         on, while the entry corresponding to the Parent Message is the one
  2430.         showed in bold.
  2431.         The  Parent  Message  is particularly important if you are linking
  2432.         messages on  MSGID/REPLY  kludges.  It is the message on which the
  2433.         thread  is  based.   The message preceding it is the message it is
  2434.         answering  to,  while all the messages following it are replies to
  2435.         it.   If  you single-click on an entry, Mail Manager will show you
  2436.         that  message  on  the  Browse  window, but it does not change the
  2437.         Parent  Message.   If  you  double-click on an entry, Mail Manager
  2438.         will  show  you that message on the Browse window, and it makes it
  2439.         the Parent Message.
  2440.         For example consider the following reply thread:
  2441.  
  2442.                                         1
  2443.                                        / \
  2444.                                       2   3
  2445.                                      /   / \
  2446.                                     4   5   6
  2447.                                        /|\   \
  2448.                                       7 8 9   10
  2449.  
  2450.         suppose  you  are reading message 3 and that it is also the Parent
  2451.         Message:   the thread window will show you messages 1-3-5-6, the 3
  2452.         will  be  active  and  in bold.  If you single-click on message 5,
  2453.         Mail Manager will show you that message in the Browse window while
  2454.         the  threads  listview will show you the same entries, but now the
  2455.         cursor  will  be  on  message  5.   If instead you double-click on
  2456.         message  5,  Mail Manager will show you that message in the Browse
  2457.         window,  but  now  the  threads  listview  will  show you messages
  2458.         3-5-7-8-9, with the 5 active and in bold.
  2459.  
  2460.  
  2461.  
  2462.       2.3.1.2  Write
  2463.  
  2464.         Calls  the  configured  Text  Editor  allowing  you to write a new
  2465.         message  in  the current area.  As soon as you close the editor it
  2466.         opens  the  Message  Parameters  Window allowing you to insert the
  2467.         Message Parameters.
  2468.  
  2469.  
  2470.  
  2471.       2.3.1.3  Forward
  2472.  
  2473.         Allows  you  to  forward  the current message to another area.  It
  2474.         opens  a  requester allowing you to select the area where you want
  2475.         to  forward the message.  It then calls the configured Text Editor
  2476.         allowing you to edit the message.  As soon as you close the editor
  2477.         it  opens  the  Message Parameters Window allowing you to edit the
  2478.         Message Parameters.
  2479.  
  2480.  
  2481.  
  2482.       2.3.1.4  Edit
  2483.  
  2484.         Allows you to modify an existing message.  It calls the configured
  2485.         Text Editor  allowing you to edit the body of the current message.
  2486.         As  soon  as  you close the editor it opens the Message Parameters
  2487.         Window allowing you to edit the Message Parameters.
  2488.  
  2489.  
  2490.  
  2491.       2.3.1.5  Edit Hdr
  2492.  
  2493.         Allows  you to modify the header of an existing message.  It opens
  2494.         the  Message Parameters Window allowing you to edit the parameters
  2495.         of the current message.
  2496.  
  2497.  
  2498.  
  2499.       2.3.1.6  Reply
  2500.  
  2501.         Allows  you  to  reply  to  the current message.  It reformats and
  2502.         quotes  the  message,  next it  calls  the  configured Text Editor
  2503.         allowing you to insert your reply.
  2504.         As  soon  as  you close the editor it opens the Message Parameters
  2505.         Window allowing you to edit the Message Parameters.
  2506.  
  2507.  
  2508.  
  2509.       2.3.1.7  X Reply
  2510.  
  2511.         Performs the same  operation as the Reply function, but it opens a
  2512.         requester  allowing  you to select the area where you want to post
  2513.         your reply.
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.     2.3.2  Browse Window Menus
  2520.  
  2521.  
  2522.       2.3.2.1  Messages
  2523.  
  2524.  
  2525.         2.3.2.1.1  Delete
  2526.  
  2527.           Toggles the status of the Deleted Flag on the current message.
  2528.  
  2529.  
  2530.  
  2531.         2.3.2.1.2  Protect
  2532.  
  2533.           Toggles the status of the Protected Flag on the current message.
  2534.  
  2535.  
  2536.  
  2537.         2.3.2.1.3  Mark
  2538.  
  2539.           Toggles the status of the Marked Flag on the current message.
  2540.  
  2541.  
  2542.  
  2543.         2.3.2.1.4  Archive
  2544.  
  2545.           Opens a file requester allowing you to select the file where you
  2546.           want to save the current message.
  2547.           You  can  configure  the  default  name  of  the  file  with the
  2548.           'Archive File' parameter.
  2549.  
  2550.  
  2551.  
  2552.         2.3.2.1.5  Print
  2553.  
  2554.           Prints the current message on the configured printer.
  2555.  
  2556.  
  2557.  
  2558.         2.3.2.1.6  Toggle UnReplied Flag
  2559.  
  2560.           Toggles the status of the UnReplied Flag on the current message.
  2561.  
  2562.  
  2563.  
  2564.  
  2565.       2.3.2.2  Miscellaneous
  2566.  
  2567.  
  2568.         2.3.2.2.1  File Request
  2569.  
  2570.           Opens  the  MM File Request window.  The Node string gadget will
  2571.           be  pre-filled  with  the  originating  address  of  the current
  2572.           message.
  2573.           You  can enter the names of the files you want to request to the
  2574.           node in the string gadget below the listview.
  2575.           To  delete  a  file  just select it from the listview, clear the
  2576.           string gadget and press enter.
  2577.           If  a  requested  file  is  already present in the .REQ file, it
  2578.           won't be added again.
  2579.  
  2580.  
  2581.  
  2582.         2.3.2.2.2  Areas Window
  2583.  
  2584.           Goes Back to the Areas Window
  2585.  
  2586.  
  2587.  
  2588.         2.3.2.2.3  Areas List
  2589.  
  2590.           Opens a requester allowing you to select the area where you want
  2591.           to go.
  2592.  
  2593.  
  2594.  
  2595.         2.3.2.2.4  Previous Area
  2596.  
  2597.           Goes to the previous area.
  2598.  
  2599.  
  2600.  
  2601.         2.3.2.2.5  Next Area
  2602.  
  2603.           Goes to the next area.
  2604.  
  2605.  
  2606.  
  2607.         2.3.2.2.6  Previous UnRead Area
  2608.  
  2609.           Goes to the previous area with unread messages.
  2610.  
  2611.  
  2612.  
  2613.         2.3.2.2.7  Next UnRead Area    
  2614.  
  2615.           Goes to the next area with unread messages.
  2616.  
  2617.  
  2618.  
  2619.         2.3.2.2.8  Export Area
  2620.  
  2621.           Performs an export of the current area.
  2622.  
  2623.  
  2624.  
  2625.  
  2626.       2.3.2.3  Environment
  2627.  
  2628.  
  2629.         2.3.2.3.1  Text Styles
  2630.  
  2631.           If this menu is selected, Mail Manager will show text surrounded
  2632.           by  one  of  the following characters in a different style:  `*'
  2633.           for bold text, `/' for italic text and `_' for underlined text.
  2634.           You  can  configure the initial state of this menu item with the
  2635.           'Text Styles' parameter.
  2636.  
  2637.  
  2638.  
  2639.         2.3.2.3.2  Show Kludges
  2640.  
  2641.           If this menu is selected, Mail Manager will show the kludges and
  2642.           the control lines of the message.
  2643.           You  can  configure the initial state of this menu item with the
  2644.           'Show Kludges' parameter.
  2645.  
  2646.  
  2647.  
  2648.         2.3.2.3.3  Quote Kludges
  2649.  
  2650.           If  this menu is selected, Mail Manager will include kludges and
  2651.           control lines in the quoted message.
  2652.           You  can  configure the initial state of this menu item with the
  2653.           'Quote Kludges' parameter.
  2654.  
  2655.  
  2656.  
  2657.  
  2658.       2.3.2.4  User
  2659.  
  2660.         This  menu   lists  all  the  user  definable  commands  you  have
  2661.         configured  as Custom Browse Commands.  When you select one of its
  2662.         items  the  associated  command will be launched with the AmigaDOS
  2663.         'Run' command.
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.     2.3.3  Browse Window ShortCuts
  2670.  
  2671.       In  the  Browse  Window  you  can  use  all  the configured keyboard
  2672.       shortcuts  for a MUI listview, besides those Mail Manager offers you
  2673.       a few extra hardcoded keyboard shortcuts for moving within messages.
  2674.  
  2675.  
  2676.       2.3.3.1 Left
  2677.  
  2678.         Reads the previous message.
  2679.  
  2680.  
  2681.       2.3.3.2  Right
  2682.  
  2683.         Reads the next message.
  2684.  
  2685.  
  2686.       2.3.3.3  Shift+Left
  2687.  
  2688.         Reads  the  previous  message in the reply thread without changing
  2689.         the parent message.
  2690.  
  2691.  
  2692.       2.3.3.4  Shift+Right
  2693.  
  2694.         Reads  the  next  message in the reply thread without changing the
  2695.         parent message.
  2696.  
  2697.  
  2698.       2.3.3.5  Alt+Left
  2699.  
  2700.         Reads  the  previous  message in the reply thread and makes it the
  2701.         the parent message.
  2702.  
  2703.  
  2704.       2.3.3.6  Alt+Right
  2705.  
  2706.         Reads  the  next  message in the reply thread and makes it the the
  2707.         parent message.
  2708.  
  2709.  
  2710.       2.3.3.7  Control+Left
  2711.  
  2712.         Reads the previous unread message.
  2713.  
  2714.  
  2715.       2.3.3.8  Control+Right
  2716.  
  2717.         Reads the next unread message.
  2718.  
  2719.  
  2720.       2.3.3.9  Space
  2721.  
  2722.         Scrolls  the message one page down.  When you reach the end of the
  2723.         message it will read the next message.
  2724.         When  you reach the end of the messages in the area it goes to the
  2725.         next  area  with  unread  messages,  and  starts reading the first
  2726.         unread message.
  2727.  
  2728.  
  2729.       2.3.3.10  Shift+Space
  2730.  
  2731.         Scrolls  the  message  one page up.  When you reach the top of the
  2732.         message it will read the previous message.
  2733.         When  you reach the top of the messages in the area it goes to the
  2734.         previous  area  with unread messages, and starts reading the first
  2735.         unread message.
  2736.  
  2737.  
  2738.       2.3.3.11  Return
  2739.  
  2740.         Scrolls  the message one page down.  When you reach the end of the
  2741.         message it will read the next unread message.
  2742.         When  you reach the end of the messages in the area it goes to the
  2743.         next  area  with  unread  messages,  and  starts reading the first
  2744.         unread message.
  2745.  
  2746.  
  2747.       2.3.3.12  Del
  2748.  
  2749.         Toggles  the  status  of  the Deleted flag on the current message,
  2750.         it then reads the next message.
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.   2.4  Message Parameters Window
  2758.  
  2759.     This  window  allows  you  to  set  or  modify  the parameters and the
  2760.     attributes of a message.
  2761.  
  2762.  
  2763.     2.4.1  From
  2764.  
  2765.        Here you can insert the name of the sender of the message.
  2766.        If  you  click  on  the  associated  popup  gadget  or if you press
  2767.        RightAmiga+'?'  while  this  string  gadget is active, Mail Manager
  2768.        will open a window where you can select one of the configured Sysop
  2769.        names.
  2770.        In  netmail  areas,  beside the From string gadget there is another
  2771.        string gadget where you can insert the address of the sender of the
  2772.        message.  Normally  you  don't  have to worry about the contents of
  2773.        this gadget, During the export operation Mail Manager will scan the
  2774.        configured   Addresses   (   Akas  won't  be  scanned  )  and  will
  2775.        automatically  choose  the  right  one ( normally the nearer to the
  2776.        destination  address  ).  If you instead want to force Mail Manager
  2777.        to  use a particular address you can insert it in the string gadget
  2778.        and  then  select  the 'Force Address' gadget.  If you click on the
  2779.        associated  popup  gadget or if you press RightAmiga+'?' while this
  2780.        string  gadget is active, Mail Manager will open a window where you
  2781.        can  select  one  of  the  configured Addresses or Akas, and if you
  2782.        select  one  of  these,  Mail Manager will automatically select the
  2783.        'Force Address' gadget.
  2784.  
  2785.  
  2786.     2.4.2  To
  2787.  
  2788.        Here you can insert the name of the addressee of the message.
  2789.        If  you insert here one of the nick names specified in the Userlist
  2790.        and  press  'Return'  Mail Manager will expand it to the associated
  2791.        name.
  2792.        If  you  instead  insert  here  the  name  of  one of the senders /
  2793.        addressees  of  the  messages  contained  in  the  area  and  press
  2794.        'Return',  Mail  Manager  will  fill  the To Address field with the
  2795.        address of the user.
  2796.        If  you  click  on  the  associated  popup  gadget  or if you press
  2797.        RightAmiga+'?'  while  this  string  gadget  is  still active, Mail
  2798.        Manager  will  open  a window where you can select one of the names
  2799.        inserted  in  the  Userlist.  If you have inserted a pattern in the
  2800.        string  gadget  (  you  can  use all the AmigaDOS wildcards ), Mail
  2801.        Manager will insert in the list only the names that match with that
  2802.        pattern.
  2803.        In  netmail  areas Mail Manager offers you also a powerful nodelist
  2804.        support ( you must have traplist.library and a compiled nodelist ).
  2805.        If  you  enter a  pattern  in  the  To string gadget and then press
  2806.        RightAmiga+'!'  while  this  string  gadget  is  still active, Mail
  2807.        Manager  will  ask you the number of the zone you want to limit the
  2808.        search to ( enter 0 for no limitation ), and then it will search in
  2809.        the  Nodelist  all the sysops that match that pattern.  It could be
  2810.        a bit slow, particularly if you do not limit the search to a single
  2811.        zone,  but  I  think  that  Mail Manager is the only one able to do
  2812.        this, and I find this really really useful.
  2813.        In  netmail  areas,  besides  the To string gadget there is another
  2814.        string  gadget where you can insert the address of the addressee of
  2815.        the  message.   As  soon  as  you  press 'Return' Mail Manager will
  2816.        expand  the  address and, if the To string gadget is empty, it will
  2817.        scan  the  nodelist  looking  for  the  node  and  if  it finds the
  2818.        corresponding entry it will fill the To string gadget with the name
  2819.        of the sysop of that node.
  2820.  
  2821.  
  2822.     2.4.3  Subj
  2823.  
  2824.        Here you can insert the subject of the message.
  2825.  
  2826.  
  2827.     2.4.4  Origin
  2828.  
  2829.        Here  you  can  insert the text that will be inserted in the origin
  2830.        line of echomail messages.
  2831.        If  you  click  on  the  associated  popup  gadget  or if you press
  2832.        RightAmiga+'?'  while  this  string  gadget  is  still active, Mail
  2833.        Manager  will  open  a  window  where  you  can  select  one of the
  2834.        configured Origin lines.
  2835.  
  2836.  
  2837.     2.4.5  Flavor
  2838.  
  2839.        This radio gadget will set the flavor of a netmail message.
  2840.  
  2841.  
  2842.     2.4.6  Private
  2843.  
  2844.        This  checkmark gadget will set the status of the Private attribute
  2845.        of a message.
  2846.  
  2847.  
  2848.     2.4.7  Reflow Text
  2849.  
  2850.       If  this  checkmark gadget is selected, Mail Manager will reflow the
  2851.       body of the message before writing it into the message base.
  2852.  
  2853.  
  2854.     2.4.8  File Attached
  2855.  
  2856.       When  you  select  this  gadget  Mail  Manager will open an ASL file
  2857.       requester  allowing you to select the file you want to attach to the
  2858.       message,  then  it  will  insert  the filename in the subject of the
  2859.       message ( the path will be removed during the export operation ).
  2860.       Mail Manager is able to manage file attached also in Echo areas, all
  2861.       you have to do is to configure the area as 'File Echo'.  Be careful,
  2862.       file  attached  in  echo  areas  are supported by a few programs and
  2863.       normally it is not legal to send them into normal echo areas.
  2864.  
  2865.  
  2866.     2.4.9  Force Address
  2867.  
  2868.       Normally  during  the  export  operation  Mail  Manager  ignores the
  2869.       address   inserted   in   the   From   Address  string  gadget,  and
  2870.       automatically choose the better one within the configured addresses.
  2871.       If  you  instead  want  to  force  Mail  Manager to use a particular
  2872.       address you can insert the address in the From Address string gadget
  2873.       and then select the 'Force Address' gadget.
  2874.  
  2875.  
  2876.     2.4.10 Multi Send
  2877.  
  2878.       This  gadget  allows you to send a netmail message to many different
  2879.       persons.   If  you select this gadget, the Message Parameters Window
  2880.       won't  be  closed when you click on the 'Ok' gadget, allowing you to
  2881.       insert  new  parameters  for  another copy of the message.  When you
  2882.       have finished you can close the window with the 'Cancel' gadget.
  2883.  
  2884.  
  2885.     2.4.11 Receipt Request
  2886.  
  2887.       Sets the Return Receipt Request attribute to a netmail message.
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895. 3  MAIL MANAGER AREXX INTERFACE
  2896.  
  2897.   Mail Manager offers you a powerful Arexx interface.
  2898.  
  2899.   Some  ARexx  commands  ( followed by a (***) in the description ), could
  2900.   create problems if the Editor isn't in the Areas Window.  MM solves this
  2901.   problem  going  automatically back to the Areas Window as soon as one of
  2902.   this commands is executed.
  2903.  
  2904.   Of  course  this  is  not a good solution if this happens while you, for
  2905.   example, are reading or writing a message.  You can solve this 'problem'
  2906.   by checking the result of the Command 'MM_AreasWin' before executing one
  2907.   of  this  commands.  If RC = 5 you can wait a few seconds with delay() (
  2908.   remember  to load the rexxsupport.library ) and check again.  As soon as
  2909.   RC = 0 you can safely launch the command.
  2910.  
  2911.   Example:
  2912.  
  2913.   /*
  2914.   ** This script shows a nice and safe way for calling the Import function
  2915.   */
  2916.  
  2917.   address 'MAILMANAGER'
  2918.  
  2919.   MM_AreasWin
  2920.   if RC ~= 0 then do
  2921.      text = 'Please go back to the Areas Window as soon as possible'
  2922.      gadget = "*_Ok"
  2923.      MM_Requester '"There is an ARexx script waiting..."' 'text' 'gadget'
  2924.      end
  2925.  
  2926.   do until RC = 0
  2927.      call Delay(250)
  2928.      MM_AreasWin
  2929.      end
  2930.  
  2931.   MM_Import
  2932.  
  2933.   exit
  2934.  
  2935.  
  2936.  
  2937.  
  2938.   3.1  Standard MUI ARexx commands
  2939.  
  2940.  
  2941.     3.1.1  Quit
  2942.  
  2943.       Syntax:    Quit
  2944.       Function:  Shuts Down Mail Manager.
  2945.  
  2946.  
  2947.  
  2948.     3.1.2  Hide
  2949.  
  2950.       Syntax:    Hide
  2951.       Function:  Iconifies Mail Manager.
  2952.  
  2953.  
  2954.  
  2955.     3.1.3  Show
  2956.  
  2957.       Syntax:    Show
  2958.       Function:  UnIconifies Mail Manager.
  2959.  
  2960.  
  2961.  
  2962.     3.1.4  Help
  2963.  
  2964.       Syntax:    Help FILE/A 
  2965.       Function:  Writes  a  list of all the ARexx commands of Mail Manager
  2966.                  to the specified file.
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.   3.2  Mail Manager internal ARexx commands
  2974.  
  2975.  
  2976.     3.2.1  Ticks Management
  2977.  
  2978.  
  2979.       3.2.1.1  MM_ImportTicks
  2980.  
  2981.         Syntax:    MM_ImportTicks
  2982.  
  2983.         Function:  Launches MM Ticks Import function
  2984.  
  2985.         Result:    RC = 0  -  All OK   
  2986.  
  2987.  
  2988.  
  2989.       3.2.1.2  MM_HatchTick
  2990.  
  2991.         Syntax:    MM_HatchTick  AREATAG/A, STEM/A
  2992.  
  2993.         Function:  Inserts a Tick File in the area specified in <AREATAG>.
  2994.  
  2995.         Input:     <STEM>.FILE - Name of the File you want to send.
  2996.                    <STEM>.DESC - File Description
  2997.                    <STEM>.REPL - File to replace
  2998.  
  2999.         Result:    RC = 0  -  All OK
  3000.                    RC = 4  -  Unknown Area
  3001.  
  3002.  
  3003.  
  3004.     3.2.2  Areas Management
  3005.  
  3006.  
  3007.       3.2.2.1  MM_Import   (***)
  3008.  
  3009.         Syntax:    MM_Import
  3010.  
  3011.         Function:  Launches MM Import function
  3012.  
  3013.         Result:    RC = 0  -  All OK   
  3014.  
  3015.  
  3016.  
  3017.       3.2.2.2  MM_Export
  3018.  
  3019.         Syntax:    MM_Export  AREATAG/F
  3020.  
  3021.         Function:  If  you  specify  an  <AREATAG>  it  Exports that Area,
  3022.                    otherwise it Exports All the Areas.
  3023.                    If  <AREATAG> = SMARTEXPORT  it  exports  all the areas
  3024.                    flagged with 'E'. Be careful, MM knows that an external
  3025.                    program has written a message into an area only after a
  3026.                    Scan  of the area.  So if an external prg has written a
  3027.                    message  into  an  area  and  you have not scanned that
  3028.                    area,   "MM_Export  'SMARTEXPORT'"  won't  export  that
  3029.                    message.  In general  'SMARTEXPORT' is useful only with
  3030.                    messages written or imported from Mail Manager.  If you
  3031.                    want  to  be  sure to export also messages written from
  3032.                    external programs you must perform a global Export.
  3033.  
  3034.         Result:    RC = 0  -  All OK
  3035.                    RC = 4  -  Unknown Area
  3036.  
  3037.  
  3038.  
  3039.       3.2.2.3  MM_Rescan
  3040.  
  3041.         Syntax:    MM_Rescan  AREATAG/A, NODE/A, FORCED/S
  3042.  
  3043.         Function:  Performs a Rescan of the Area <AREATAG> for Node <NODE>.
  3044.                    If  you  specify the switch 'FORCED', MM will Export to
  3045.                    the Node also messages already exported to the node.
  3046.  
  3047.         Result:    RC = 0  -  All OK
  3048.                    RC = 1  -  Reserved
  3049.                    RC = 2  -  Reserved
  3050.                    RC = 3  -  Unknown Node
  3051.                    RC = 4  -  Unknown Area
  3052.  
  3053.  
  3054.  
  3055.       3.2.2.4  MM_Scan
  3056.  
  3057.         Syntax:    MM_Scan  AREATAG/F
  3058.  
  3059.         Function:  If  you  specify  an  <AREATAG>  it  Scans  that  Area,
  3060.                    otherwise it Scans All the Areas
  3061.  
  3062.         Result:    RC = 0  -  All OK
  3063.                    RC = 4  -  Unknown Area
  3064.  
  3065.  
  3066.  
  3067.       3.2.2.5  MM_Free   (***)
  3068.  
  3069.         Syntax:    MM_Free  AREATAG/F
  3070.  
  3071.         Function:  If  you  specify  an  <AREATAG>  it  Frees  the  Memory
  3072.                    associated   to   that   Area  and  writes  the  Index.
  3073.                    Otherwise it Frees All the Areas
  3074.  
  3075.         Result:    RC = 0  -  All OK
  3076.                    RC = 4  -  Unknown Area
  3077.  
  3078.  
  3079.  
  3080.       3.2.2.6  MM_Update
  3081.  
  3082.         Syntax:    MM_Update  AREATAG/F
  3083.  
  3084.         Function:  If  you  specify  an  <AREATAG>  it  writes  the  Index
  3085.                    associated  to  that Area.  Otherwise it writes All the
  3086.                    Indexes.  In  any  case  it  won't  free the associated
  3087.                    Memory.
  3088.  
  3089.         Result:    RC = 0  -  All OK
  3090.                    RC = 4  -  Unknown Area
  3091.  
  3092.  
  3093.  
  3094.       3.2.2.7  MM_WriteStats
  3095.  
  3096.         Syntax:    MM_WriteStats
  3097.  
  3098.         Function:  Writes the Statistics File
  3099.  
  3100.         Result:    RC = 0  -  All OK
  3101.  
  3102.  
  3103.  
  3104.       3.2.2.8  MM_Renumber
  3105.  
  3106.         Syntax:    MM_Renumber  AREATAG/F
  3107.  
  3108.         Function:  If  you  specify  an  <AREATAG> it Renumbers that Area,
  3109.                    Otherwise it Renumbers all the Areas.  This function is
  3110.                    active only only with Areas in PLAIN or IDX MsgBases.
  3111.                    Be  careful !!!  This function does not update the link
  3112.                    fields  of  the  message header ( used for example from
  3113.                    DLG ), so DLG users should renumber their MsgBases only
  3114.                    with the DLG internal Renumber function.
  3115.  
  3116.         Result:    RC = 0  -  All OK
  3117.                    RC = 4  -  Unknown Area
  3118.  
  3119.  
  3120.  
  3121.       3.2.2.9  MM_Optimize 
  3122.  
  3123.         Syntax:    MM_Optimize  AREATAG/F
  3124.  
  3125.         Function:  If you specify an  <AREATAG> it Optimizes the text file
  3126.                    of  that  Area,  Otherwise  it Optimizes all the Areas.
  3127.                    This  function  is  active  only with Areas in Quick or
  3128.                    Compressed MsgBases
  3129.  
  3130.         Result:    RC = 0  -  All OK
  3131.                    RC = 4  -  Unknown Area
  3132.  
  3133.  
  3134.  
  3135.       3.2.2.10  MM_Delete   (***)
  3136.  
  3137.         Syntax:    MM_Delete  AREATAG/F
  3138.  
  3139.         Function:  If  you  specify an  <AREATAG> it Deletes Messages from
  3140.                    that Area.  Otherwise  it Deletes Messages from all the
  3141.                    Areas.
  3142.  
  3143.         Result:    RC = 0  -  All OK
  3144.                    RC = 4  -  Unknown Area
  3145.  
  3146.  
  3147.  
  3148.       3.2.2.11  MM_Purge   (***)
  3149.  
  3150.         Syntax:    MM_Purge  AREATAG/F
  3151.  
  3152.         Function:  If  you  specify an  <AREATAG> it Deletes Messages from
  3153.                    that  Area.  Otherwise it Deletes Messages from all the
  3154.                    Areas.  In any case UnRead Messages won't be deleted
  3155.  
  3156.         Result:    RC = 0  -  All OK
  3157.                    RC = 4  -  Unknown Area
  3158.  
  3159.  
  3160.  
  3161.       3.2.2.12  MM_CleanArea   (***)
  3162.  
  3163.         Syntax:    MM_CleanArea  AREATAG/A
  3164.  
  3165.         Function:  It  scans the  area specified in <AREATAG> deleting all
  3166.                    the Messages flagged as 'DEL'
  3167.  
  3168.         Result:    RC = 0  -  All OK
  3169.                    RC = 4  -  Unknown Area
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.     3.2.3  Messages Management
  3178.  
  3179.  
  3180.       3.2.3.1  MM_EditMsgFlags
  3181.  
  3182.         Syntax:    MM_EditMsgFlags  AREATAG/A, MSGNUM/A, VARNAME/A
  3183.  
  3184.         Function:  Edits  the  Flags of the Message number <MSGNUM> in the
  3185.                    Area  <AREATAG>  using  data  stored  in  the  variable
  3186.                    <VARNAME>.
  3187.                    Possible values for the flags stored in <VARNAME>:
  3188.  
  3189.                             Sets the Flag     Clears the Flag
  3190.                             -------------     ---------------
  3191.                                  UNR               !UNR
  3192.                                  SYS               !SYS
  3193.                                  READ              !READ
  3194.                                  SENT              !SENT
  3195.                                  MARK              !MARK
  3196.                                  SAFE              !SAFE
  3197.                                  DEL               !DEL
  3198.  
  3199.         Result:    RC = 0  -  All OK
  3200.                    RC = 4  -  Unknown Area or Unknown Msg
  3201.  
  3202.  
  3203.  
  3204.       3.2.3.2  MM_SearchMsgs
  3205.  
  3206.         Syntax:    MM_SearchMsgs  AREATAG/A,STEM/A,FROM/A,TO/A,SUBJ/A,FLAGS/M
  3207.  
  3208.         Function:  Fills the Stem <STEM> with the Number of the Messages of
  3209.                    the  Area  <AREATAG> that match the Patterns ( AmigaDOS
  3210.                    wildcards  allowed  ) specified in <FROM>, <TO>, <SUBJ>
  3211.                    with the Attributes <FLAGS>.
  3212.  
  3213.                    Possible values for <FLAGS>:
  3214.  
  3215.                    SENT   - MSG has been already Exported
  3216.                    INTR   - MSG  isn't  addressed  to one of the Addresses
  3217.                             or Akas configured.
  3218.                    READ   - MSG has been Read
  3219.                    UNR    - MSG is UnReplied
  3220.                    IMP    - MSG has been Imported
  3221.                    !SENT  - MSG Must be Exported
  3222.                    !INTR  - MSG  is  addressed  to  one  of  the Addresses
  3223.                             or Akas configured.
  3224.                    !READ  - MSG hasn't been Read
  3225.                    !UNR   - MSG in Replied
  3226.                    !IMP   - MSG  hasn't  been Imported (was written on the
  3227.                             system)
  3228.  
  3229.  
  3230.         Result:    RC = 0  -  All OK
  3231.                    RC = 4  -  Unknown Area
  3232.                    <STEM>.COUNT - Number of Messages in the Stem
  3233.                    <STEM>.<n>   - Number of the Msg ( <n> = 0 to COUNT-1 )
  3234.  
  3235.  
  3236.  
  3237.       3.2.3.3  MM_ReadMsg
  3238.  
  3239.         Syntax:    MM_ReadMsg  AREATAG/A, MSGNUM/A, STEM/A
  3240.  
  3241.         Function:  Reads the Message number <MSGNUM> in the Area <AREATAG>
  3242.                    and fills the Stem <STEM>
  3243.  
  3244.         Result:    RC = 0  -  All OK
  3245.                    RC = 4  -  Unknown Area or Unknown Message
  3246.                    <STEM>.FROM       - Name of the Sender of the Msg
  3247.                    <STEM>.FROMADDR   - Address of the Sender of the Msg
  3248.                    <STEM>.TO         - Name of the Addressee of the Msg
  3249.                    <STEM>.TOADDR     - Address of the Addressee of the Msg
  3250.                    <STEM>.SUBJ       - Subject of the Msg
  3251.                    <STEM>.DATE       - Creation Date of the Msg
  3252.                    <STEM>.FLAGS      - Flags of the Msg
  3253.                                        PVT CRASH HOLD SENT INTR KILL RRR FATT
  3254.                                        UNR SYS READ IMP MARK SAFE DEL
  3255.                    <STEM>.HEAD.COUNT - Number of Kludge Lines in the Msg
  3256.                    <STEM>.HEAD.<n>   - Kludge Line Number <n>
  3257.                                        ( <n> = 0 to COUNT-1 )
  3258.                    <STEM>.TEXT.COUNT - Number of Text Lines in the Msg
  3259.                    <STEM>.TEXT.<n>   - Text Line Number <n>
  3260.                                        ( <n> = 0 to COUNT-1 )
  3261.                    <STEM>.FOOT.COUNT - Number of Control Lines in the Msg
  3262.                                        (Tear,Origin,Seen-By,Path,Via Node)
  3263.                    <STEM>.FOOT.<n>   - Control Line Number <n>
  3264.                                        ( <n> = 0 to COUNT-1 )
  3265.  
  3266.  
  3267.  
  3268.       3.2.3.4  MM_WriteMsg
  3269.  
  3270.         Syntax:    MM_WriteMsg  AREATAG/A, STEM/A
  3271.  
  3272.         Function:  Writes  a  message  in  the Area <AREATAG> reading data
  3273.                    from Stem <STEM>
  3274.  
  3275.         Input:     <STEM>.FROM     - Name of the Sender of the Msg.
  3276.                                      Default:  name  specified  as Default
  3277.                                      Sysop.
  3278.  
  3279.                    <STEM>.FROMADDR - Address of the Sender of the Msg
  3280.                                      The  address  passed  here  WON'T  be
  3281.                                      changed  during  Export.  If you want
  3282.                                      to  use  your  Address  nearer to the
  3283.                                      destination  of the MSG you must pass
  3284.                                      an empty string ("") here.
  3285.  
  3286.                    <STEM>.TO        - Name of the Addressee of the Msg
  3287.                                       Default: ""
  3288.  
  3289.                    <STEM>.TOADDR    - Address of the Addressee of the Msg.
  3290.                                       If  the area is a  NetMail  area you
  3291.                                       MUST supply a valid address
  3292.  
  3293.                    <STEM>.SUBJ      - Subject of the Msg. Default: ""
  3294.  
  3295.                    <STEM>.TEAR      - The  contents  of this variable will
  3296.                                       be  added to the end of the standard
  3297.                                       MM tear line. Max 16 Chrs.
  3298.                                       Default:  ""
  3299.  
  3300.                    <STEM>.ORIGIN    - Origin line      Default: The origin
  3301.                                       configured for the area.
  3302.  
  3303.                    <STEM>.FLAGS     - Flags of the Msg: REFLOW, PVT, CRASH,
  3304.                                       SENT, FATT, KILL, HOLD, RRR,
  3305.                                       Default: "PVT" in NetMail areas
  3306.  
  3307.                    <STEM>.FILE      - Name  of the file containing the Text
  3308.                                       of the MSG.   Default: "T:MM.TRANS"
  3309.  
  3310.         Result:    RC = 0  -  All OK
  3311.                    RC = 4  -  Unknown Area
  3312.  
  3313.  
  3314.  
  3315.       3.2.3.5  MM_EditMsg
  3316.  
  3317.         Syntax:    MM_EditMsg  AREATAG/A, MSGNUM/A, STEM/A
  3318.  
  3319.         Function:  Edits the Message number <MSGNUM> in the Area <AREATAG>
  3320.                    using data stored in the Stem <STEM>.
  3321.                    Undefined  fields  or empty fields leave unchanged that
  3322.                    part of the header.
  3323.  
  3324.         Input:     <STEM>.FROM      - Name of the Sender of the Msg
  3325.  
  3326.                    <STEM>.FROMADDR  - Address of the Sender of the Msg
  3327.  
  3328.                    <STEM>.TO        - Name of the Addressee of the Msg
  3329.  
  3330.                    <STEM>.TOADDR    - Address of the Addressee of the Msg
  3331.  
  3332.                    <STEM>.SUBJ      - Subject of the Msg
  3333.  
  3334.                    <STEM>.FLAGS     - Flags of the Msg 
  3335.                                       Set the Flag     Clear the Flag
  3336.                                       ------------     --------------
  3337.                                           PVT               !PVT
  3338.                                           CRASH             !CRASH
  3339.                                           SENT              !SENT
  3340.                                           FATT              !FATT
  3341.                                           KILL              !KILL
  3342.                                           HOLD              !HOLD
  3343.                                           RRR               !RRR
  3344.  
  3345.                    <STEM>.FILE      - Name  of the file containing the Text
  3346.                                       of  the  MSG.  If not specified, the
  3347.                                       text will be left unchanged.
  3348.  
  3349.         Result:    RC = 0  -  All OK
  3350.                    RC = 4  -  Unknown Area or Unknown Msg
  3351.  
  3352.  
  3353.  
  3354.       3.2.3.6  MM_DeleteMsg   (***)
  3355.  
  3356.         Syntax:    MM_DeleteMsg  AREATAG/A, MSGNUM/A
  3357.  
  3358.         Function:  Deletes the Msg number <MSGNUM> in the Area <AREATAG>
  3359.  
  3360.         Result:    RC = 0  -  All OK
  3361.                    RC = 4  -  Unknown Area or Unknown Msg
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.     3.2.4  Configuration Management
  3370.  
  3371.  
  3372.       3.2.4.1  MM_LoadCfg   (***)
  3373.  
  3374.         Syntax:    MM_LoadCfg  FILE/F
  3375.  
  3376.         Function:  Loads  the  configuration.  If <FILE> is not specified,
  3377.                    it will reload the actual configuration file.
  3378.  
  3379.         Result:    RC = 0  -  All OK
  3380.  
  3381.  
  3382.  
  3383.       3.2.4.2  MM_SaveCfg
  3384.  
  3385.         Syntax:    MM_SaveCfg  FILE/F
  3386.  
  3387.         Function:  Saves  the  Configuration.  If <FILE> is not specified,
  3388.                    it  will  save  the configuration with the same name of
  3389.                    the last loaded configuration File.
  3390.  
  3391.         Result:    RC = 0  -  All OK
  3392.  
  3393.  
  3394.  
  3395.       3.2.4.3  MM_GetSysop
  3396.  
  3397.         Syntax:    MM_GetSysop  VARNAME/A
  3398.  
  3399.         Function:  Fills the variable <VARNAME> with the Name of the SysOp
  3400.  
  3401.         Result:    RC = 0  -  All OK
  3402.  
  3403.  
  3404.  
  3405.       3.2.4.4  MM_GetAddrs
  3406.  
  3407.         Syntax:    MM_GetAddrs  STEM/A
  3408.  
  3409.         Function:  Fills the Stem <STEM> with your Addresses and Akas
  3410.  
  3411.         Result:    RC = 0  -  All OK
  3412.                    <STEM>.COUNT - Number of configured Nodes
  3413.                    <STEM>.<n>   - Address of you Address <n>
  3414.                                   <n> = 0 to COUNT-1
  3415.  
  3416.  
  3417.  
  3418.       3.2.4.5  MM_GetNearestAddr
  3419.  
  3420.         Syntax:    MM_GetNearestAddr NODE/A, VARNAME/A
  3421.  
  3422.         Function:  Fills  the variable <VARNAME> with your Address nearest
  3423.                    to the Node <NODE>.  It doesn't considers your Akas.
  3424.  
  3425.         Result:    RC = 0  -  All OK
  3426.  
  3427.  
  3428.  
  3429.       3.2.4.6  MM_GetGroups
  3430.  
  3431.         Syntax:    MM_GetGroups  STEM/A
  3432.  
  3433.         Function:  Fills  the  Stem <STEM> with the name of the Groups
  3434.                    configured
  3435.  
  3436.         Result:    RC = 0  -  All OK
  3437.                    <STEM>.COUNT - Number of configured Groups
  3438.                    <STEM>.<n>   - Name of the Group <n>
  3439.                                   <n> = 0 to COUNT-1
  3440.  
  3441.  
  3442.  
  3443.       3.2.4.7  MM_GetGroupAreas
  3444.  
  3445.         Syntax:    MM_GetGroupAreas  STEM/A, GROUP/A, LEVEL/A
  3446.  
  3447.         Function:  Fills  the  Stem  <STEM>  with  the Names  of the Areas
  3448.                    belonging  to  the group <GROUP>, and the access levels
  3449.                    required for the areas within the group.
  3450.                    If  <LEVEL>  !=  0  MM  will  return only areas with an
  3451.                    access level <= <LEVEL>
  3452.  
  3453.         Result:    RC = 0  -  All OK
  3454.                    RC = 4  -  Unknown Group
  3455.                    <STEM>.COUNT     - Number  of  Areas  belonging  to the
  3456.                                       group
  3457.                    <STEM>.<n>.AREA  - Tag Name of the Area <n>
  3458.                                       <n> = 0 to COUNT-1 
  3459.                    <STEM>.<n>.LEVEL - access  level required for this area
  3460.                                       within the group.
  3461.  
  3462.  
  3463.  
  3464.       3.2.4.8  MM_GetGroupTickAreas
  3465.  
  3466.         Syntax:    MM_GetGroupTickAreas  STEM/A, GROUP/A, LEVEL/A
  3467.  
  3468.         Function:  Fills  the Stem <STEM> with the Names of the Tick Areas
  3469.                    belonging  to  the group <GROUP>, and the access levels
  3470.                    required for the areas within the group.
  3471.                    If  <LEVEL> != 0,  MM  will  return  only areas with an
  3472.                    access level <= <LEVEL>
  3473.  
  3474.         Result:    RC = 0  -  All OK
  3475.                    RC = 4  -  Unknown Group
  3476.                    <STEM>.COUNT - Number of Areas belonging to the group
  3477.                    <STEM>.<n>.AREA  - Name of the Area number <n>
  3478.                                       <n> = 0 to COUNT-1 
  3479.                    <STEM>.<n>.LEVEL - access  level  required for area <n>
  3480.                                       within the group.
  3481.  
  3482.  
  3483.  
  3484.       3.2.4.9  MM_GetNodes
  3485.  
  3486.         Syntax:    MM_GetNodes  STEM/A
  3487.  
  3488.         Function:  Fills  the  Stem <STEM> with the Addresses of the Nodes
  3489.                    configured
  3490.  
  3491.         Result:    RC = 0  -  All OK
  3492.                    <STEM>.COUNT - Number of configured Nodes
  3493.                    <STEM>.<n>   - Address of the Node <n>
  3494.                                   <n> = 0 to COUNT-1
  3495.  
  3496.  
  3497.  
  3498.       3.2.4.10  MM_GetNodeInfo
  3499.  
  3500.         Syntax:    MM_GetNodeInfo  NODE/A, STEM/A
  3501.  
  3502.         Function:  Fills  the  Stem <STEM> with some information about the
  3503.                    Node <NODE>
  3504.  
  3505.         Result:    RC = 0  -  All OK
  3506.                    RC = 3  -  Unknown Node
  3507.                    <STEM>.ADDRDIM        - Dim. of the  Seen-By/Path lines
  3508.                                            in  messages  exported  to  the
  3509.                                            Node:  2, 4, 5.
  3510.                    <STEM>.PACKDIM        - Dim.  of  the  PKTs created for
  3511.                                            the Node:  3, 4, 5.
  3512.                    <STEM>.ECHOFLAVOR     - Flavor of Echomail PKTs created
  3513.                                            for  the Node:  NORMAL, DIRECT,
  3514.                                            HOLD, CRASH, VIRTUAL.
  3515.                    <STEM>.TICKFLAVOR     - Flavor  of  Tick Files  created
  3516.                                            for  the Node:  NORMAL, DIRECT,
  3517.                                            HOLD, CRASH, VIRTUAL.
  3518.                    <STEM>.PKTPW          - Packet Password for the Node
  3519.                    <STEM>.AREAFIXPW      - AreaFix Password for the Node
  3520.                    <STEM>.TICKPW         - Tick Password for the Node
  3521.                    <STEM>.USERFLAGS      - User Flags for the Node
  3522.                    <STEM>.GROUPCOUNT     - Number   of  groups   the  node
  3523.                                            belongs to.
  3524.                    <STEM>.GROUPNAME.<n>  - Name of the group number <n>
  3525.                                            <n> = 0 to GROUPCOUNT-1
  3526.                    <STEM>.GROUPLEVEL.<n> - Access level of the Node within
  3527.                                            the group number <n>
  3528.                    <STEM>.AREA.COUNT     - Number  of  Areas  the node  is
  3529.                                            connected to.
  3530.                    <STEM>.AREA.<n>       - Tag Name of the area number <n>
  3531.                                            <n> = 0 to AREA.COUNT - 1
  3532.                    <STEM>.TICKAREA.COUNT - Number  of  the  Tick Areas the
  3533.                                            node is connected to.
  3534.                    <STEM>.TICKAREA.<n>   - Tag   Name  of  the  Tick  Area
  3535.                                            number <n>.
  3536.                                            <n> = 0 to TICKAREA.COUNT - 1
  3537.  
  3538.  
  3539.  
  3540.       3.2.4.11  MM_GetCfgPaths
  3541.  
  3542.         Syntax:    MM_GetCfgPaths  STEM/A
  3543.  
  3544.         Function:  Fills the Stem <STEM> with some paths configured.
  3545.  
  3546.         Result:    RC = 0  -  All OK
  3547.                    <STEM>.EDITOR      - Editor command
  3548.                    <STEM>.INBOUND     - Inbound dir
  3549.                    <STEM>.OUTBOUND    - Outbound dir
  3550.                    <STEM>.BUNDLEDIR   - Outgoing Bundles dir
  3551.                    <STEM>.TICDIR      - Outgoing *.TIC dir
  3552.                    <STEM>.TEMPPKTDIR  - Temporary Outgoing Pkts dir
  3553.                    <STEM>.BADDIR      - Bad dir
  3554.                    <STEM>.BACKUPDIR   - Backup dir
  3555.                    <STEM>.WORKDIR     - Working dir
  3556.                    <STEM>.MAILDEV     - Mail device
  3557.                    <STEM>.USERLIST    - UserList file
  3558.                    <STEM>.NODELISTDIR - Nodelist dir
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.       3.2.4.12  MM_GetAreas
  3565.  
  3566.         Syntax:    MM_GetAreas  STEM/A, AREATYPES/M
  3567.  
  3568.         Function:  Fills  the  Stem <STEM> with the Tag Names of the Areas
  3569.                    configured.   If  you  specify  some AREATYPES, MM will
  3570.                    consider  only  areas  with  those AreaTypes.  Possible
  3571.                    values for <AREATYPES>:
  3572.                    MAIL   - Areas of type MAIL
  3573.                    FECHO  - Areas of type FECHO
  3574.                    ECHO   - Areas of type ECHO  and  FECHO
  3575.                    BAD    - Areas of type BAD
  3576.  
  3577.         Result:    RC = 0  -  All OK
  3578.                    <STEM>.COUNT - Number of configured Areas
  3579.                    <STEM>.<n>   - Tag Name of the Area <n>
  3580.                                   <n> = 0 to COUNT-1
  3581.  
  3582.  
  3583.  
  3584.       3.2.4.13  MM_GetAreaInfo
  3585.  
  3586.         Syntax:    MM_GetAreaInfo  AREATAG/A, STEM/A
  3587.  
  3588.         Function:  Fills  the  Stem <STEM> with some information about the
  3589.                    Area <AREATAG>
  3590.  
  3591.         Result:    RC = 0  -  All OK
  3592.                    RC = 4  -  Unknown Area
  3593.                    <STEM>.NAME       - Name of the area
  3594.                    <STEM>.DESC       - Description of the area
  3595.                    <STEM>.PATH       - Path of the area
  3596.                    <STEM>.ALTPATH    - Alternate Path of the area
  3597.                    <STEM>.GROUP      - Name of the group this area belongs
  3598.                                        to
  3599.                    <STEM>.LEVEL      - Access level required for this area
  3600.                                        within the group
  3601.                    <STEM>.ADDR       - Your Address in this area
  3602.                    <STEM>.NODE.COUNT - Number of Nodes linked to the area
  3603.                    <STEM>.NODE.<n>   - Addresses of node number <n>
  3604.                                        <n> = 0 to COUNT-1 
  3605.                    <STEM>.TYPE       - Type of the area: MAIL, ECHO, FECHO,
  3606.                                        BAD
  3607.                    <STEM>.MBASE      - Message Base used for the area:
  3608.                                        PLAIN, IDX, QUICK, COMP, PTHRO
  3609.                    <STEM>.NMSG       - Number of the Messages in the area
  3610.                    <STEM>.HIMSG      - Number of the last Message in the
  3611.                                        area
  3612.  
  3613.  
  3614.  
  3615.       3.2.4.14  MM_CreateArea
  3616.  
  3617.         Syntax:    MM_CreateArea  AREATAG/A, PATH/A, ADDR/A, MSGBASE/A,
  3618.                                   GROUP/A, GROUPLEVEL/A, NODE/A
  3619.  
  3620.         Function:  Creates a New Echo Area adding it to the configuration,
  3621.                    then saves it.  It also connects the Node <NODE> to the
  3622.                    Area.  The area is created with the following defaults:
  3623.  
  3624.                    Tag        = <AREATAG>
  3625.                    Name       = Tag
  3626.                    Path       = <PATH>Tag/
  3627.                    Address    = <ADDR>
  3628.                    MsgBase    = <MSGBASE> - PLAIN, IDX, QUICK, COMP, PTHRO
  3629.                    Show       = All
  3630.                    OrderBy    = Number
  3631.                    DeleteBy   = Number
  3632.                    NDelete    = 200
  3633.                    GroupName  = <GROUP>
  3634.                    GroupLevel = <GROUPLEVEL>
  3635.  
  3636.  
  3637.         Result:    RC = 0  -  All OK
  3638.                    RC = 1  -  Area Already defined
  3639.                    RC = 2  -  Unknown Address
  3640.                    RC = 3  -  Unknown Node
  3641.                    RC = 4  -  Unknown Group
  3642.  
  3643.  
  3644.  
  3645.       3.2.4.15  MM_AddAreaNode
  3646.  
  3647.         Syntax:    MM_AddAreaNode  AREATAG/A, NODE/A, ACCESS/F
  3648.  
  3649.         Function:  Connects the Node <NODE> to Area <AREATAG>.
  3650.                    If you  specify  READONLY  as <ACCESS>, messages coming
  3651.                    from that node won't be imported in the area.
  3652.                    If  you  instead specify WRITEONLY as <ACCESS> messages
  3653.                    won't be exported to that node,
  3654.  
  3655.  
  3656.         Result:    RC = 0  -  All OK
  3657.                    RC = 1  -  The Node is already Connected to the Area
  3658.                    RC = 2  -  Reserved
  3659.                    RC = 3  -  Unknown Node
  3660.                    RC = 4  -  Unknown Area
  3661.  
  3662.  
  3663.  
  3664.       3.2.4.16  MM_DelAreaNode
  3665.  
  3666.         Syntax:    MM_DelAreaNode  AREATAG/A, NODE/A
  3667.  
  3668.         Function:  Disconnect the Node <NODE> from Area <AREATAG>
  3669.  
  3670.         Result:    RC = 0  -  All OK
  3671.                    RC = 1  -  Node is not connected to the Area
  3672.                    RC = 2  -  Reserved
  3673.                    RC = 3  -  Unknown Node
  3674.                    RC = 4  -  Unknown Area
  3675.  
  3676.  
  3677.  
  3678.       3.2.4.17  MM_GetTickAreas
  3679.  
  3680.         Syntax:    MM_GetTickAreas  STEM/A
  3681.  
  3682.         Function:  Fills  the  Stem <STEM>  with the Tag Names of the Tick
  3683.                    Areas configured.
  3684.  
  3685.         Result:    RC = 0  -  All OK
  3686.                    <STEM>.COUNT - Number of configured Areas
  3687.                    <STEM>.<n>   - Tag Name of the Area number <n>
  3688.                                   <n> = 0 to COUNT-1
  3689.  
  3690.  
  3691.  
  3692.       3.2.4.18  MM_GetTickAreaInfo
  3693.  
  3694.         Syntax:    MM_GetTickAreaInfo  AREATAG/A, STEM/A
  3695.  
  3696.         Function:  Fills  the  Stem <STEM> with some information about the
  3697.                    Tick Area <AREATAG>
  3698.  
  3699.         Result:    RC = 0  -  All OK
  3700.                    RC = 4  -  Unknown Area
  3701.                    <STEM>.DESC       - Description of the area
  3702.                    <STEM>.PATH       - Path of the area
  3703.                    <STEM>.ALTPATH    - Alternate Path of the area
  3704.                    <STEM>.GROUP      - Name of the group this area belongs
  3705.                                        to
  3706.                    <STEM>.LEVEL      - Access level required for this area
  3707.                                        within the group
  3708.                    <STEM>.ADDR       - Your Address in this area
  3709.                    <STEM>.NODE.COUNT - Number of Nodes linked to the area
  3710.                    <STEM>.NODE.<n>   - Address of nodes number <n>
  3711.                                        <n> = 0 to COUNT-1
  3712.  
  3713.  
  3714.  
  3715.       3.2.4.19  MM_AddTickAreaNode
  3716.  
  3717.         Syntax:    MM_AddTickAreaNode  AREATAG/A, NODE/A, ACCESS/F
  3718.  
  3719.         Function:  Connects the Node <NODE> to the Tick Area <AREATAG>
  3720.                    If  you specify READONLY as <ACCESS>, Tick files coming
  3721.                    from that node won't be imported in the area.
  3722.                    If you instead specify WRITEONLY as <ACCESS> Tick files
  3723.                    won't be exported to that node,
  3724.  
  3725.         Result:    RC = 0  -  All OK
  3726.                    RC = 1  -  The Node is already Connected to the Area
  3727.                    RC = 2  -  Reserved
  3728.                    RC = 3  -  Unknown Node
  3729.                    RC = 4  -  Unknown Area
  3730.  
  3731.  
  3732.  
  3733.  
  3734.       3.2.4.20  MM_DelTickAreaNode
  3735.  
  3736.         Syntax:    MM_DelTickAreaNode  AREATAG/A, NODE/A
  3737.  
  3738.         Function:  Disconnect the Node <NODE> from Area <AREATAG>
  3739.  
  3740.         Result:    RC = 0  -  All OK
  3741.                    RC = 1  -  The Node is not connected to the Area
  3742.                    RC = 2  -  Reserved
  3743.                    RC = 3  -  Unknown Node
  3744.                    RC = 4  -  Unknown Area
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.     3.2.5  Miscellaneous Management
  3753.  
  3754.  
  3755.       3.2.5.1  MM_GetNodelistNode
  3756.  
  3757.         Syntax:    MM_GetNodelistNode  NODE/A, STEM/A
  3758.  
  3759.         Function:  Finds  the  node  <NODE>  in the nodelist and fills the
  3760.                    Stem <STEM> with some information about the node.
  3761.  
  3762.         Result:    RC = 0  -  All OK
  3763.                    RC = 4  -  Unknown Node
  3764.                    RC = 5  -  Unable to open the Nodelist
  3765.                    <STEM>.SYSTEM   - Name of the System
  3766.                    <STEM>.SYSOP    - Name of the Sysop
  3767.                    <STEM>.CITY     - City and State
  3768.                    <STEM>.PHONE    - Phone Number
  3769.                    <STEM>.BAUDRATE - Baud Rate
  3770.                    <STEM>.FLAGS    - Nodelist Flags
  3771.  
  3772.  
  3773.  
  3774.       3.2.5.2  MM_RequestFiles
  3775.  
  3776.         Syntax:    MM_RequestFiles  NODE/A, STEM/A
  3777.  
  3778.         Function:  Opens  the MM FileRequest window, and fills it with the
  3779.                    node <NODE> and the files listed in the Stem <STEM>.
  3780.  
  3781.         Input:     <STEM>.COUNT  - Number of files to be requested
  3782.                    <STEM>.<n>    - File number <n>.  <n> = 0 to COUNT-1
  3783.  
  3784.         Result:    RC = 0  -  All OK   
  3785.  
  3786.  
  3787.  
  3788.       3.2.5.3  MM_AddToFlow
  3789.  
  3790.         Syntax:    MM_AddToFlow  FILE/A, NODE/A, TYPE/A
  3791.  
  3792.         Function:  Adds the file <FILE> to a Flow file of type <TYPE> for
  3793.                    the Node <NODE>.  If the File is already present in the
  3794.                    Flow File, it will NOT be added again.
  3795.  
  3796.         Input:     <TYPE>  - Type of the Flow File:
  3797.                              REQ, NORMAL, DIRECT, CRASH, HOLD
  3798.  
  3799.         Result:    RC = 0  -  All OK   
  3800.  
  3801.  
  3802.  
  3803.       3.2.5.4  MM_AreasWin
  3804.  
  3805.         Syntax:    MM_AreasWin
  3806.  
  3807.         Function:  Check if the Areas Window is opened
  3808.  
  3809.         Result:    RC = 0  -  Areas Window is opened or MM is iconified
  3810.                    RC = 5  -  Areas Window is not opened
  3811.  
  3812.  
  3813.  
  3814.       3.2.5.5  MM_WriteLog
  3815.  
  3816.         Syntax:    MM_WriteLog  VARNAME/A, LEVEL/A
  3817.  
  3818.         Function:  Writes  the  string  contained in <VARNAME> to the logs
  3819.                    with a LogLevel higher than <LEVEL>
  3820.  
  3821.         Result:    RC = 0  -  All OK
  3822.  
  3823.  
  3824.  
  3825.       3.2.5.6  MM_CloseLog
  3826.  
  3827.         Syntax:    MM_CloseLog
  3828.  
  3829.         Function:  Closes the Log file
  3830.  
  3831.         Result:    RC = 0  -  All OK
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.     3.2.6  Requesters Management
  3840.  
  3841.       3.2.6.1  MM_Requester
  3842.  
  3843.         Syntax:    MM_Requester  TITLE/A, TEXTVAR/A, GADGETSVAR/A
  3844.  
  3845.         Function:  Opens  a  MUI  requester containing the text stored in
  3846.                    <TEXTVAR> and allowing the user to select on one of the
  3847.                    gatdgets specified in <GADGETSVAR>
  3848.  
  3849.         Input:     <TITLE>      - Title of the Requester
  3850.                    <TEXTVAR>    - Name of the variable containing the Text
  3851.                                   of the Requester
  3852.                    <GADGETSVAR> - Name  of  the  variable  containing  the
  3853.                                   possible  answers to the requester.  The
  3854.                                   format looks like '*_Save|_Use|_Cancel'
  3855.                                   A  '_'  character indicates the keyboard
  3856.                                   shortcut for this gadget.
  3857.                                   A  '*'  character  indicates the default
  3858.                                   gadget for the requester
  3859.  
  3860.         Result:    RC = <n> - <n> = Number of the selected gadget
  3861.                                from left to right = 1, 2, ..., 0.
  3862.  
  3863.  
  3864.  
  3865.       3.2.6.2  MM_StringReq
  3866.  
  3867.         Syntax:    MM_StringReq  TITLE/A, VARNAME/A
  3868.  
  3869.         Function:  Opens  a  MUI  requester  allowing  the user to enter a
  3870.                    string.
  3871.  
  3872.         Input:     <TITLE>    - Title of the Requester
  3873.                    <VARNAME>  - The default value of the requester will be
  3874.                                 read from <VARNAME>, and the same variable
  3875.                                 will be filled with the string inserted by
  3876.                                 the user
  3877.  
  3878.         Result:    RC = 0 - The user pressed the OK gadget
  3879.                    RC = 1 - The user pressed the Cancel gadget
  3880.                    RC = 2 - The requester cannot be opened (MM iconified)
  3881.  
  3882.  
  3883.  
  3884.       3.2.6.3  MM_FileReq
  3885.  
  3886.         Syntax:    MM_FileReq  VARNAME/A
  3887.  
  3888.         Function:  Opens  a  File  Requester allowing the user to select a
  3889.                    File
  3890.  
  3891.         Input  :   <VARNAME>  - The default value of the requester will be
  3892.                                 read from <VARNAME>, and the same variable
  3893.                                 will  be  filled with the File Selected by
  3894.                                 the user
  3895.  
  3896.         Result:    RC = 0 - The user pressed the OK gadget
  3897.                    RC = 1 - The user pressed the Cancel gadget
  3898.                    RC = 2 - The requester cannot be opened (MM iconified)
  3899.  
  3900.  
  3901.  
  3902.       3.2.6.4  MM_AreaReq
  3903.  
  3904.         Syntax:    MM_AreaReq VARNAME/A
  3905.  
  3906.         Function:  Opens  a  MUI  Requester allowing the user to select an
  3907.                    Area
  3908.  
  3909.         Input:   <VARNAME> - Name of the variable that will be filled with
  3910.                              the Tag Name of the Area Selected by the user
  3911.  
  3912.         Result:    RC = 0 - The user pressed the OK gadget
  3913.                    RC = 1 - The user pressed the Cancel gadget
  3914.                    RC = 2 - The requester cannot be opened (MM iconified)
  3915.  
  3916.  
  3917.  
  3918.       3.2.6.5  MM_SingleSelReq
  3919.  
  3920.         Syntax:   MM_SingleSelReq INSTEM/A,OUTSTEM/A,TITLE/A,OUTSTEMTYPE/A
  3921.  
  3922.         Function: Opens  a  MUI  requester  with  a  SingleSelect ListView
  3923.                   filled   with   the   entries   listed   in  <INSTEM>.
  3924.                   <INSTEM>.COUNT  should  be  filled  with  the  number of
  3925.                   entries.    If  <OUTSTEM>.COUNT  =  1  <OUTSTEM>.0  will
  3926.                   contain the entry selected from the user.
  3927.  
  3928.         Input:    <INSTEM>.COUNT - Number of entries to be inserted in the
  3929.                                    listView
  3930.                   <INSTEM>.<n>    - Entry  number  <n>. <n> = 0 to COUNT-1
  3931.                   <TITLE>         - Title of the Requester
  3932.                   <OUTSTEMTYPE>   - Specifies  the  Type of value returned
  3933.                                     in <OUTSTEM>:  NUM, STR
  3934.                                     NUM - number of the selected entry
  3935.                                     STR - value of the selected entry
  3936.  
  3937.  
  3938.         Result:    RC = 0 - The user pressed the OK gadget
  3939.                    RC = 1 - The user pressed the Cancel gadget
  3940.                    RC = 2 - The requester cannot be opened (MM iconified)
  3941.  
  3942.                    <OUTSTEM>.COUNT - 0 = No entry selected
  3943.                                      1 = One Entry Selected
  3944.                    <OUTSTEM>.0     - Selected Entry
  3945.  
  3946.  
  3947.  
  3948.       3.2.6.6  MM_MultiSelReq
  3949.  
  3950.         Syntax:    MM_MultiSelReq INSTEM/A,OUTSTEM/A,TITLE/A,OUTSTEMTYPE/A
  3951.  
  3952.         Function:  Opens  a  MUI  requester  with  a  MultiSelect ListView
  3953.                    filled   with   the   entries   listed   in   <INSTEM>.
  3954.                    <INSTEM>.COUNT  should  be  filled  with  the number of
  3955.                    entries. It fills the  Stem  <OUTSTEM> with the entries
  3956.                    selected from the user.  The number of selected entries
  3957.                    will be stored in <OUTSTEM>.COUNT
  3958.  
  3959.         Input:     <INSTEM>.COUNT - Number  of  entries  to be inserted in
  3960.                                     the listView
  3961.                    <INSTEM>.<n>   - Entry  number  <n>. <n> = 0 to COUNT-1
  3962.                    <TITLE>        - Title of the Requester
  3963.                    <OUTSTEMTYPE>  - Specifies  the  Type of value returned
  3964.                                     in <OUTSTEM>:  NUM, STR
  3965.                                     NUM - number of the selected entry
  3966.                                     STR - value of the selected entry
  3967.  
  3968.         Result:    RC = 0 - The user pressed the OK gadget
  3969.                    RC = 1 - The user pressed the Cancel gadget
  3970.                    RC = 2 - The requester cannot be opened (MM iconified)
  3971.  
  3972.                    <OUTSTEM>.COUNT - Number of entries selected
  3973.                                      0 = No entry selected
  3974.                    <OUTSTEM>.<n>   - Selected Entry number <n>
  3975.                                      <n> = 0 to COUNT-1
  3976.  
  3977.  
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.     3.2.7  Stems Management
  3984.  
  3985.  
  3986.       3.2.7.1  MM_WriteStem
  3987.  
  3988.         Syntax:    MM_WriteStem FILE/A, STEM/A, APPEND/S
  3989.  
  3990.         Function:  Writes  to  the  file <FILE> the lines contained in the
  3991.                    Stem <STEM> adding a LF to the end of every line.
  3992.                    If  you specify the switch 'APPEND', MM will append the
  3993.                    lines to an existing file.
  3994.  
  3995.         Input:     <FILE>       - Output file
  3996.                    <STEM>.COUNT - Number of lines in <STEM>
  3997.                    <STEM>.<n>   - Line number <n>  <n> = 0 to COUNT-1
  3998.  
  3999.         Result:    RC = 0  -  All OK
  4000.  
  4001.  
  4002.  
  4003.       3.2.7.2  MM_ReadStem
  4004.  
  4005.         Syntax:    MM_ReadStem FILE/A, STEM/A, APPEND/S
  4006.  
  4007.         Function:  Fills  the  Stem <STEM> with the lines contained in the
  4008.                    text file <FILE>.  Every line must end with a LF.
  4009.                    If  you specify the switch 'APPEND', MM will append the
  4010.                    lines  to  the  end  of  the Stem ( <STEM>.COUNT should
  4011.                    contain the number of lines already in the Stem ).
  4012.  
  4013.         Input:     <FILE>       - Input file
  4014.                    <STEM>.COUNT - Number of lines already in <STEM>.
  4015.                    <STEM>.<n>   - Line number <n>  <n> = 0 to COUNT-1
  4016.  
  4017.         Result:    RC = 0  -  All OK
  4018.                    <STEM>.COUNT - Number of lines in <STEM>.
  4019.                    <STEM>.<n>   - Line number <n>  <n> = 0 to COUNT-1
  4020.  
  4021.  
  4022.  
  4023.       3.2.7.3  MM_SearchInStem
  4024.  
  4025.         Syntax:    MM_SearchInStem INSTEM/A,OUTSTEM/A,PATTERN/A,OUTSTEMTYPE/A
  4026.  
  4027.         Function:  Fills   the Stem <OUTSTEM> with the entries in the Stem
  4028.                    <INSTEM>  that  match  with the pattern <PATTERN>.  The
  4029.                    search is CASE INSENSITIVE.
  4030.  
  4031.         Input:     <INSTEM>.COUNT - Number of entries in <INSTEM>
  4032.                    <INSTEM>.<n>   - Entry number <n>  <n> = 0 to COUNT-1
  4033.                    <PATTERN>      - Matching pattern
  4034.                                     All AmigaDOS WildCards are allowed
  4035.                    <OUTSTEMTYPE>  - Specifies  the  Type of value returned
  4036.                                     in <OUTSTEM>:  NUM, STR
  4037.                                     NUM - number of the selected entry
  4038.                                     STR - value of the selected entry
  4039.  
  4040.         Result:    RC = 0  -  All OK
  4041.                    <OUTSTEM>.COUNT  - Number of entries in <OUTSTEM>
  4042.                    <OUTSTEM>.<n>    - Entry number <n>  <n> = 0 to COUNT-1
  4043.  
  4044.  
  4045.  
  4046.       3.2.7.4  MM_AddToStem
  4047.  
  4048.         Syntax:    MM_AddToStem  STEM/A, VARNAME/A
  4049.  
  4050.         Function:  Adds  the contents of the variable <VARNAME> to the end
  4051.                    of the Stem <STEM>
  4052.  
  4053.         Input:     <STEM>.COUNT  - Number of entries in <STEM>
  4054.                    <STEM>.<n>    - Entry number <n>  <n> = 0 to COUNT-1
  4055.                    <VARNAME>     - the  contents  of this variable will be
  4056.                                    added to the end of the Stem
  4057.  
  4058.         Result:    RC = 0  -  All OK
  4059.  
  4060.  
  4061.  
  4062.       3.2.7.5  MM_SortStem
  4063.  
  4064.         Syntax:    MM_SortStem  STEM/A
  4065.  
  4066.         Function:  Sorts the Stem <STEM> in alphabetical order.
  4067.                    The sorting is CASE SENSITIVE
  4068.  
  4069.         Input:     <STEM>.COUNT  - Number of entries in <STEM>
  4070.                    <STEM>.<n>    - Entry number <n>  <n> = 0 to COUNT-1 
  4071.  
  4072.         Result:    RC = 0  -  All OK
  4073.  
  4074.  
  4075.  
  4076.       3.2.7.6  MM_SortAddresses
  4077.  
  4078.         Syntax:    MM_SortAddresses  STEM/A
  4079.  
  4080.         Function:  Sorts the Addresses contained in the Stem <STEM>
  4081.  
  4082.         Input:     <STEM>.COUNT  - Number of entries in <STEM>
  4083.                    <STEM>.<n>    - Entry number <n>  <n> = 0 to COUNT-1
  4084.  
  4085.         Result:    RC = 0  -  All OK
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.     3.2.8  Files Management
  4094.  
  4095.  
  4096.       3.2.8.1  MM_CRCFile
  4097.  
  4098.         Syntax:    MM_CRCFile  FILE/A, VARNAME/A
  4099.  
  4100.         Function:  Fills  the  variable  <VARNAME>  with the CRC-32 of the
  4101.                    file <FILE>.
  4102.  
  4103.         Result:    RC = 0  -  All OK
  4104.  
  4105.  
  4106.  
  4107.       3.2.8.2  MM_CopyFile
  4108.  
  4109.         Syntax:    MM_CopyFile  FROM/A, TO/A
  4110.  
  4111.         Function:  Copies  the  file  <FROM>  to  the  file <TO>.  If <TO>
  4112.                    already exists, MM will append a ",n" with n = 1 to 999
  4113.                    to the destination filename.
  4114.                    The FileNote will be preserved
  4115.  
  4116.         Result:    RC = 0  -  All OK
  4117.  
  4118.  
  4119.  
  4120.       3.2.8.3  MM_MoveFile
  4121.  
  4122.         Syntax:    MM_MoveFile  FROM/A, TO/A
  4123.  
  4124.         Function:  Moves  the  file  <FROM>  to  the  file  <TO>.  If <TO>
  4125.                    already exists, MM will append a ",n" with n = 1 to 999
  4126.                    to the destination filename.
  4127.                    The FileNote will be preserved
  4128.  
  4129.         Result:    RC = 0  -  All OK
  4130.  
  4131.  
  4132.  
  4133.       3.2.8.4  MM_DeleteFile
  4134.  
  4135.         Syntax:    MM_DeleteFile  FILE/A
  4136.  
  4137.         Function:  Deletes the file <FILE>
  4138.  
  4139.         Result:    RC = 0  -  All OK
  4140.  
  4141.  
  4142.  
  4143.       3.2.8.5  MM_SetFileNote
  4144.  
  4145.         Syntax:    MM_SetFileNote  FILE/A, VARNAME/A
  4146.  
  4147.         Function:  Fills the FileNote of the file <FILE> with the contents
  4148.                    of  the  variable  <VARNAME>.  The note may be up to 80
  4149.                    characters long
  4150.  
  4151.         Result:    RC = 0  -  All OK
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158. 4  MISCELLANEOUS
  4159.  
  4160.   4.1  Support
  4161.  
  4162.     If  you  have any suggestions, questions or BUG reports, you can reach
  4163.     me or my support-team at this addresses:
  4164.  
  4165.             Pino Aliberti                   German Support
  4166.             2:335/602.2@fidonet             Siggi Weisner
  4167.             39:102/10.0@amiganet            2:2448/7022.0@fidonet
  4168.             aliberti@maui.nervous.com       39:170/505.29@amiganet
  4169.  
  4170.     There  is  also  an  international Amiganet Echomail conference called
  4171.     MM_AMY,  which  should  be  available  at  major backbones.  This Area
  4172.     will  allow  the users and the  author of Mail Manager to  get  closer
  4173.     together and keep a closer contact.
  4174.     In  this  area,  you  can  freely  exchange  your experience with Mail
  4175.     Manager and discuss future enhancements you would like to see etc.
  4176.     The  availability  of  new  versions of Mail Manager will be announced
  4177.     there, too!
  4178.  
  4179.  
  4180.  
  4181.   4.2  Registration
  4182.  
  4183.     Mail Manager  is  offered to you under the concepts of ShareWare.
  4184.     You  can  use  it  for  an  evaluation period of up to 4 weeks without
  4185.     paying  any  charge.   If  you are going to use Mail Manager after the
  4186.     evaluation period, you MUST register.
  4187.  
  4188.     The unregistered version of Mail Manager has some limitations:
  4189.     - The ARexx interface is disabled
  4190.     - The Optimize function is disabled
  4191.     - There are some registration requesters.
  4192.  
  4193.     Actually  it  is possible to register your copy of Mail Manager at one
  4194.     of these sites:
  4195.  
  4196.      Italy          - Pino Aliberti  2:335/602.2@fidonet
  4197.      Germany        - Siggi Weisner  2:2448/7022.0@fidonet
  4198.  
  4199.     The  method  for  registering  at  each  of  these  sites  is a little
  4200.     different, so please read the instructions for each very carefully.
  4201.  
  4202.     **********************************************************************
  4203.     *                                                                    *
  4204.     *  NO  PERSON(S)  OR  BUSINESSES  OTHER  THAN  ME  AND  THE  LISTED  *
  4205.     *   SUPPORTERS  ARE  AUTHORIZED  TO ACCEPT  ANY  REGISTRATION  OR    *
  4206.     *                         DISTRIBUTION FEES.                         *
  4207.     *                                                                    *
  4208.     **********************************************************************
  4209.  
  4210.  
  4211.     ITALY ( AND REST OF THE WORLD )
  4212.     =====
  4213.  
  4214.     In  order  to  register yourself you have to fill out the registration
  4215.     form  in  "MM:Registration/World"  and  send  it,  together  with  the
  4216.     registration fee to:
  4217.  
  4218.                              Giuseppe Aliberti
  4219.                            via  delle Fontanelle
  4220.                             67016 Paganica (AQ)
  4221.                                   ITALY
  4222.  
  4223.     You  can  optionally fill out the registration form with a text editor
  4224.     and send it via netmail ( CRASH MAIL ONLY ) to 2:335/602.2.
  4225.  
  4226.     It  is also possible to register MUI together with Mail Manager, there
  4227.     is  a  special bundle offer, and you will get the MUI keyfile together
  4228.     with the Mail Manager one.
  4229.  
  4230.     The registration fee for Mail Manager is:
  4231.  
  4232.                          Point Only           Full Node
  4233.                       -----------------   ------------------
  4234.           Itl Lire      50000 (35000)       100000 (85000)
  4235.           DM               50    (35)          100    (85)
  4236.           US $             35    (25)           70    (60)
  4237.           UK £             23    (15)           46    (38)
  4238.  
  4239.  
  4240.     The registration fee for Mail Manager together with MUI is:
  4241.  
  4242.                          Point Only           Full Node
  4243.                       -----------------   ------------------
  4244.           Itl Lire      75000 (60000)       125000 (110000)
  4245.           DM               73    (58)          123    (108)
  4246.           US $             50    (40)           85     (75)
  4247.           UK £             33    (25)           56     (48)
  4248.  
  4249.  
  4250.     The fee between brackets is reserved only to Registered Users of Point
  4251.     Manager v3.10 and higher.
  4252.  
  4253.     You  can send money as cash, but please, be careful.
  4254.     The  safest and easiest way to send your registration fee is to use an
  4255.     International  Postal Money Order, in this case USE ONLY International
  4256.     Postal  Money  Orders  in  ITALIAN  LIRE  (Italian Users can send me a
  4257.     Vaglia Postale).  Your local post office will happily provide you with
  4258.     more information about this.
  4259.     You can also use an Eurocheque in Italian Lire.
  4260.  
  4261.     I WILL NOT accept any other type of payment !
  4262.  
  4263.  
  4264.     GERMANY
  4265.     =======
  4266.  
  4267.      Please refer to the German version of the Manual. Thanks !
  4268.  
  4269.  
  4270.  
  4271.   4.3  About MUI
  4272.  
  4273.     MUI  is  a  system to generate and maintain graphical user interfaces.
  4274.     With  the aid of a preferences program, the user of an application has
  4275.     the ability to customize the outfit according to his personal taste.
  4276.  
  4277.     MUI  is  distributed  as  shareware.   To  obtain  a  complete package
  4278.     containing  lots  of  examples and more information about registration
  4279.     please  look  for  a  file  called "muiXXusr.lha" (XX means the latest
  4280.     version  number)  on  your  local  bulletin boards or on public domain
  4281.     disks.
  4282.  
  4283.     MUI is (c) Copyright 1992-94 by Stefan Stuntz
  4284.  
  4285.  
  4286.  
  4287.   4.4  MUI Hints & Tips
  4288.  
  4289.     Here there are only a few hints to improve your Mail Manager GUI:
  4290.  
  4291.     The  numbers specified with the \<n> sequence in the Area Name are not
  4292.     the  numbers  of the corresponding color in the screen palette but the
  4293.     numbers of the System Pen you want to use, in particular:
  4294.  
  4295.         0 - Detail          
  4296.         1 - Block     
  4297.         2 - Text      
  4298.         3 - Shine     
  4299.         4 - Shadow    
  4300.         5 - Fill      
  4301.         6 - Filltext  
  4302.         7 - Background
  4303.         8 - Highlight 
  4304.  
  4305.     You can assign to every pen the color you prefer from the Edit Palette
  4306.     window  of the MUI Prefs.  [System -> Select the right screen from the
  4307.     popup -> Edit -> Palette].
  4308.  
  4309.     For example these are my Screen Colors and my System Pens assignments:
  4310.  
  4311.                        Screen Colors
  4312.                       ---------------
  4313.  
  4314.          Color      Red    Green    Blu
  4315.         
  4316.            0        149     149     149        Grey
  4317.            1          0       0       0        Black
  4318.            2        255     255     255        White
  4319.            3         59     103     162        Sky-Blue
  4320.            4        123     123     123        Dark-Grey
  4321.            5        175     175     175        Light-Grey
  4322.            6        255     255       0        Yellow
  4323.            7        255     169     151        Pink
  4324.  
  4325.  
  4326.                         System Pens
  4327.                       ---------------
  4328.  
  4329.             Pen                Color Assigned
  4330.  
  4331.          0 - Detail              0    Grey
  4332.          1 - Block               1    Black
  4333.          2 - Text                1    Black
  4334.          3 - Shine               2    White
  4335.          4 - Shadow              1    Black
  4336.          5 - Fill                3    Sky-Blue
  4337.          6 - Filltext            2    White
  4338.          7 - Background          0    Grey
  4339.          8 - Highlight           6    Yellow
  4340.  
  4341.  
  4342.     So with \3 the text will be White and with \8 the text will be Yellow.
  4343.  
  4344.     Another  hint:  normally MUI uses, as default colors for the different
  4345.     selection  state  of a ListView entry, three colors really much alike.
  4346.     This  is  an  unlucky  choice  !  There is a big difference between an
  4347.     active entry ( the one with the cursor on ), and a selected entry.
  4348.  
  4349.     I've solved the problem by using the following colors (from the Images
  4350.     window of MUI Prefs):
  4351.  
  4352.     BG Listview Cursor            Pen -> Colormap -> Color n-1 (color 7)
  4353.     BG Listview Selected          Pen -> Colormap -> Color 3
  4354.     BG Listview Selected+Cursor   Rast-> Fill/Back Raster
  4355.  
  4356.  
  4357.  
  4358.   4.5  Licence Agreement
  4359.  
  4360.     Mail Manager  is  offered to you under the concepts of ShareWare.
  4361.     You  can  use  it  for  an  evaluation period of up to 4 weeks without
  4362.     paying  any  charge.   If  you are going to use Mail Manager after the
  4363.     evaluation period, you MUST register.
  4364.     By  copying,  distributing  and/or using the program you indicate your
  4365.     acceptance of this license to do so, and all its terms and conditions.
  4366.  
  4367.     You May:
  4368.      -  install  and  use  this software for your personal use on a single
  4369.         microcomputer
  4370.      -  make  verbatim copies of the original distribution archive without
  4371.         any files being omitted/added/changed.
  4372.      -  distribute those copies of the software if NO charge is asked for,
  4373.         except for the media.
  4374.      -  upload the software to as many BBSes as you like
  4375.  
  4376.      You May NOT:
  4377.      -  copy  and/or  distribute  this  program  without  the accompanying
  4378.         documentation  and  other  additional  files  that  come  with the
  4379.         original distribution archive.
  4380.      -  alter the software and/or the accompanying files in any way
  4381.      -  copy and/or distribute modified version of this program.
  4382.      -  decompile,  disassemble, translate, convert to another programming
  4383.         language or otherwise reverse engineer the software.
  4384.      -  grant sublicences, leases or other rights in the software
  4385.      -  rent the software to others
  4386.  
  4387.      The  program  is  released  "as  is",  without  any  warranty, either
  4388.      expressed  or  implied,  and  in  no  event  I will be liable for any
  4389.      damages caused by the use of this program.
  4390.  
  4391.  
  4392.  
  4393.   4.6  Acknowledgements
  4394.  
  4395.     The following names are either trademarks or the efforts of the person
  4396.     and/or company listed:
  4397.  
  4398.     Amiga and AmigaDOS   are trademarks of Commodore-Amiga, Inc.
  4399.     Fido and FidoNet     are trademarks of Tom Jennings, Fido Software.
  4400.     ARexx     by William S. Hawes, Wishful Thinking Development Corp.
  4401.     MUI       by Stefan Stuntz
  4402.     MagicWb   by Martin Huttenloher
  4403.     EMS       by Davide Masserenti
  4404.     Spot      by Nico Francois
  4405.     TrapDoor  by Maximilian Hantsch and Martin Laubach
  4406.  
  4407.  
  4408.     Many thanks to:
  4409.  
  4410.       Alessandra (Ciccia)     For her love !
  4411.  
  4412.  
  4413.     ...and to the BEST BetaTesting team:
  4414.  
  4415.       Edwin Halsema           the beta tester that every programmer wants.
  4416.                               ........ or never wants ?!  *:^]
  4417.  
  4418.       Eric Krieger            for  his  fantastic  help during the testing
  4419.                               phase  and  for his fantastic translation of
  4420.                               the docs in AmigaGuide format.
  4421.  
  4422.       Siggi Weisner           --  German Registration and Support site  --
  4423.                               For  his  fantastic  help during the testing
  4424.                               phase,  for his German translation,  for his
  4425.                               help  with  the  German  users and for being
  4426.                               a  fantastic  friend.   Many  Thanks also to
  4427.                               Claudia, for her patience !
  4428.  
  4429.       Maurizio Fabiani        The   Boss   !!!   For  his   support,   for
  4430.                               permitting  me  to know Fidonet and for MAUI
  4431.                               for AMIGA, the best BBS for Amiga Users.
  4432.  
  4433.       Massimo  Brogioni       The first Node that installed Mail Manager.
  4434.                               Thanks  Massimo  for your  trust and for all
  4435.                               your incredible help !
  4436.  
  4437.       Paolo Carotenuto        I've simply no words !  You are great Paolo,
  4438.                               maybe the greatest !
  4439.  
  4440.       Robert Hofmann          Do you want your program to be a great one ?
  4441.                               Ask Robert to be a BetaTester, but please be
  4442.                               careful, high doses could be lethal !  *:^]
  4443.  
  4444.       Marco Musso             For the installation script, for the Italian
  4445.                               translation  and  for  his  help  during the
  4446.                               testing   phase,   he   always  has  a  good
  4447.                               suggestion.
  4448.  
  4449.       Stig Poulsen            He wasn't one of the firsts to join the Mail
  4450.                               Manager  Project,  but  he is a great tester
  4451.                               and   he  should  have  joined  the  project
  4452.                               before !
  4453.  
  4454.       Frank Geider            For  his  suggestions  and  for  the  French
  4455.                               translation.
  4456.  
  4457.       Gaetano Ble'            for his help, and for his hospitality.
  4458.  
  4459.       Ferran Delriu           For his support.
  4460.  
  4461.       Andreas Mann            For his suggestions and Bug reports.
  4462.  
  4463.       Andreas Netscher        For his suggestions and Bug reports.
  4464.  
  4465.  
  4466.       many many thanks also to:
  4467.  
  4468.       Angelo  Verdone,  Bernd  Ernesti,  Cristiano Zanella, Felice Murolo,
  4469.       Riccardo  Vratogna,  Andrea  Modenese,  Danilo  Aghemo,  Piergiorgio
  4470.       Ghezzo,   Gianmarco   Giovannelli,  Erik  Boersting,  Stefan  Bauer,
  4471.       Frederic Aleixendri, Eugene Stepanoff, Regis Rampnoux, Matteo Penna,
  4472.       Florent Monteilhet, Federico Medolago Albani, Sandro Tolaini.
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.                 "Omne tulit punctum, qui miscuit utile dulci"
  4482.  
  4483.                          (Orazio,  Arte Poet., 343)
  4484.  
  4485.  
  4486.